DomoAI Enterprise API · REST

Domo API

Add AI video generation to your product

Generate videos from text, animate images, apply viral templates and create talking avatars — all over a simple REST API. Send a request, get a task ID, collect the video by polling or webhook.

$0.02per credit
from $0.04per second of video
Nevercredits expire
# Create a text-to-video task
curl -X POST https://api.domoai.com/v1/video/text2video \
  -H "Authorization: Bearer $DOMOAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A girl on a rooftop at sunset, wind in her hair",
    "model": "t2v-2.4-faster",
    "style": "japanese_anime",
    "seconds": 5,
    "aspect_ratio": "9:16"
  }'

# → { "code": 0, "data": { "task_id": "…" } }
Capabilities

What you can build with the API

Base URL: https://api.domoai.com/v1

Official docs ↗
POST/video/text2video

Text to Video

Generate a clip from a prompt in styles like anime, realistic, pixel or 90s.

2–5 credits / s
POST/video/image2video

Image to Video

Animate a still image or character design, with an optional motion prompt.

2–5 credits / s
POST/video/template2video

Template to Video

Apply viral templates — hug, 360 view, zoom, crane up, groove dance and more.

2 credits / s
POST/video/talking-avatar

Talking Avatar

Make a face in an image or video speak your audio — up to 60 seconds.

3 credits / s
POSTvideo to video

Video to Video

Restyle footage with anime and illustration models. See the official docs for the endpoint.

5 credits / s
GET/tasks/{task_id}

Get Task

Check status and collect output video URLs when a task finishes.

Free
Quick start

Your first video in 4 steps

Full integration guide →
  1. 01

    Create an API key

    In the DomoAI Enterprise dashboard, open API Keys and create one. It’s shown only once — store it in a secrets manager.

  2. 02

    Buy credits

    Top up in Dashboard → Billing. Credits cost $0.02 each and never expire.

  3. 03

    Create a task

    POST to an endpoint with Authorization: Bearer <key>. You get back a task_id.

  4. 04

    Get the result

    Poll GET /tasks/{task_id} or receive a webhook, then download the video.

Reference

Request parameters

All requests are JSON. Images, video and audio are sent as bytes_base64_encoded or a domoai_uri.

ParameterTypeRequiredDetails
promptstringYes1–2,000 characters
secondsintegerYes1–10
modelstringNot2v-2.4-faster (default) or t2v-2.4-advanced
stylestringNojapanese_anime, realistic, pixel, cartoon_game, flat_color_anime, 90s_style
aspect_ratiostringNo16:9, 9:16, 1:1 (default), 4:3, 3:4
callback_urlstring (URI)NoWebhook for task updates, up to 2,083 characters
Async tasks

Task lifecycle, polling & webhooks

Every generation runs asynchronously. Creating a task returns a task_id immediately.

PENDING→QUEUING→PROCESSING→SUCCESSorFAILED/CANCELED

Polling

Call GET /tasks/{task_id} every few seconds until the status is final. Simple and great for scripts, prototypes and batch jobs.

Webhooks (recommended for production)

Add a callback_url when you create the task and DomoAI will send status updates to your server — no polling loop needed.

Important: output video URLs expire after 8 hours. Download each finished video to your own storage right away.

GET /tasks/{task_id} → 200
{
  "code": 0,
  "data": {
    "task_id": "<TASK_ID>",
    "status": "SUCCESS",
    "category": "TEXT_TO_VIDEO",
    "seconds": 5,
    "output_videos": [
      { "url": "<VIDEO_URL>", "width": 1024, "height": 1024 }
    ],
    "credits": 10,
    "inputs": {
      "model": "t2v-2.4-faster",
      "prompt": "<YOUR_PROMPT>",
      "seconds": 5,
      "aspect_ratio": "1:1"
    },
    "created_at": "<TIMESTAMP>"
  }
}
Pricing

Pay per second of video

1 credit = $0.02. Credits never expire. You’re charged by output duration and model.

Official pricing ↗
Endpoint · modelCredits / sUSD / s5 s clip
Text / Image to Video · faster2$0.04$0.20
Text / Image to Video · advanced5$0.10$0.50
Template to Video · all templates2$0.04$0.20
Talking Avatar · v13$0.06$0.30
Video to Video · anime & illustration5$0.10$0.50

Cost calculator

Credits / video–
Cost / video–
Monthly cost–
Errors

Common errors & fixes

Troubleshooting →
StatusMeaningWhat to do
401Invalid, missing or revoked API keyCheck the Authorization: Bearer header and that the key is still active
402Not enough creditsTop up in Dashboard → Billing, then retry
403Organization banned (code 4002)Contact DomoAI support — review the usage policy
422Validation errorCheck field names and ranges — e.g. seconds must be 1–10 (1–60 for talking avatar)
FAILEDTask finished without outputLog the task, adjust the input or prompt, and retry with backoff
Production checklist

Security & best practices

Protect your key

  • Keep API keys on the server — never in browser or app code
  • Store them in environment variables or a secrets manager
  • Rotate keys if one may have leaked

Harden webhooks

  • Serve your callback URL over HTTPS
  • Verify requests with a shared secret or custom header
  • Rate-limit and make handlers idempotent

Build for scale

  • Retry 5xx and timeouts with exponential backoff
  • Download outputs before URLs expire (8 h)
  • Log task IDs and credits for cost tracking
Use cases

What developers build

Solutions →
Creator app example

Creator apps

“Turn your selfie into anime” features inside photo and social apps.

Content automation example

Content automation

Generate daily Shorts and Reels from a prompt queue or spreadsheet.

Templates example

Viral template features

One-tap hug, 360 view or dance effects for your users’ photos.

Talking avatar example

Avatar & support bots

Turn text-to-speech replies into talking-head videos for onboarding and help.

What is the Domo API?

The DomoAI Enterprise API is a REST API for generating videos with DomoAI’s models from your own app or backend — text to video, image to video, templates, talking avatars and video-to-video restyling.

How do I authenticate?

Create an API key in the DomoAI Enterprise dashboard and send it in every request as Authorization: Bearer YOUR_API_KEY. The key is shown only once, so store it securely on your server.

How much does the Domo API cost?

Credits cost $0.02 each and never expire. Faster text and image models use 2 credits per second ($0.04), advanced models and video-to-video use 5 ($0.10), templates use 2, and talking avatar uses 3 ($0.06).

How long can generated videos be?

Text, image and template videos can be 1–10 seconds per task. Talking avatar tasks can be 1–60 seconds.

Should I use polling or webhooks?

Polling GET /tasks/{task_id} is simplest for scripts and prototypes. For production, pass a callback_url so DomoAI notifies your server when a task changes status.

How long are output video URLs valid?

Output URLs expire after 8 hours, so download each finished video to your own storage as soon as the task succeeds.

Ship AI video this week.

Create a key, top up credits from $0.02 each, and make your first API call in minutes.

Get an API key ↗ Read the integration guide