Christmas Dance Trend API

Turn two photos into a 14-second Christmas duo dance video. Each person follows the built-in choreography and keeps the original music, with 480p, 720p, 1080p or 4K output.

Developer API pricing

Provider: SeeAPI

USD estimate: $0.0037 / credit · Estimated equivalent, not an additional charge.

480p: 307 credits/gen (≈ $1.15/gen)

720p: 668 credits/gen (≈ $2.50/gen)

1080p: 1,655 credits/gen (≈ $6.20/gen)

4k: 3,417 credits/gen (≈ $12.80/gen)

API examples

These examples were generated through real calls to the SeeAPI API. Choose a case to explore the inputs and actual generated results.

Examples 1

Input

reference_imagesreference_images

Portrait used for the performer who starts on the left

Portrait used for the performer who starts on the right

Output 1

Result 1

These examples are saved API results. Actual generated results may vary.

Request

POST/v1/templates/christmas-dance-trend/generations

AuthorizationSend your API key in the Authorization header using the Bearer scheme.Authorization: Bearer ****************

Header Params

stringrequired

Use a unique key for each new generation. Retry the same request with the same key and unchanged request body.

Example:: template-order-001

Body Params

application/json

stringrequired

Public provider identifier. Always send "seeapi".

Other provider values are rejected.

Allowed:seeapi

Default:: seeapi
Example:: seeapi

objectrequired

Template inputs.

Use only the fields listed here.

array <url>required

Performer references. Send an array of exactly two HTTPS image URLs, each containing one person.

The first image is assigned to the performer who starts on the left; the second image is assigned to the performer who starts on the right.
Each person keeps the face, hairstyle and visible outfit from their photo while following the built-in choreography.
Use JPEG, JPG, PNG, WebP, BMP, TIFF or GIF. Each image must be smaller than 30 MB.
Width and height must each be greater than 300 px and less than 6,000 px.
The width-to-height ratio of each image must be greater than 0.4 and less than 2.5.
The image URL must be publicly accessible without login or authentication and link directly to the image file, not a webpage.

min items: 2max items: 2

Example:: ["https://example.com/person-left.jpg","https://example.com/person-right.jpg"]

stringoptional

Output video resolution. Defaults to 720p.

Allowed values are 480p, 720p, 1080p and 4k. Resolution affects the template estimate.
The output video is always 14 seconds long, matching the built-in dance reference.

Allowed:480p720p1080p4k

Default:: 720p
Example:: 720p

stringoptional

Output video aspect ratio. Defaults to 9:16 when omitted.

Choose an explicit ratio when you need a landscape, portrait or square layout.

Allowed:16:99:161:14:33:421:9adaptive

Default:: 9:16
Example:: 9:16

numberoptional

Generation seed, from 0 to 999999. Defaults to 0.

Using the same seed does not guarantee an identical generated performance.

min: 0max: 999999

Default:: 0
Example:: 0

string <uri>optional

Optional absolute HTTPS URL for generation.succeeded and generation.failed webhooks.

Responses

202Generation accepted. Poll GET /v1/generations/{task_id} for results; acceptance is not completion.

Bodyapplication/json

objectrequired

stringrequired

Example:: task_example

stringrequired

Public template ID.

Example:: christmas-dance-trend

stringrequired

Allowed:seeapi

Example:: seeapi

objectrequired

Normalized customer input only.

Example:: {"reference_images":["https://customer.example.com/input-1.jpg","https://customer.example.com/input-2.jpg"],"resolution":"720p","aspect_ratio":"9:16","seed":0}

stringrequired

Allowed:processing

numberrequired

Request-specific template estimate in customer credits; obtain an estimate with Quote Template. The example value is illustrative, not this template's price.

Example:: 10

numberrequired

Example:: 0

numberrequired

Example:: 0

string <date-time>required

Example:: 2026-01-01T00:00:00.000Z

string <date-time>required

Example:: 2026-01-01T00:00:00.000Z

booleanrequired

Allowed:false

Example:: false

200Idempotent replay with the task's current status, recorded credits, and available result or public error. The task may already be completed.

Bodyapplication/json

objectrequired

stringrequired

Public template ID.

Example:: christmas-dance-trend

stringrequired

Allowed:seeapi

Example:: seeapi

objectrequired

Normalized customer input only.

stringrequired

Allowed:processingsucceededfailedcanceledrefundedexpired

numberrequired

Estimate recorded on the original task in customer credits.

numberrequired

objectoptional

array <object>required

stringrequired

Allowed:imagevideo

string <uri>required

stringrequired

integerrequired

stringoptional

string <date-time>required

string <date-time>optional

booleanrequired

Allowed:true

Example:: true

400

Invalid request or public template input

401

Invalid API key

402

Insufficient credits

403

API key scope or access denied

404

Template or task not found or unavailable

409

Template configuration changed, idempotency conflict, or request still being created

413

Request body too large

429

Rate limit exceeded

503

Service temporarily unavailable

Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task DetailsLearn how to query task status and retrieve generation results

Keep generation.id from the creation response. Use it as task_id when querying the generation, or receive terminal events at your HTTPS callback_url.

Note

HTTP 202 confirms acceptance only. Wait for the terminal task status before showing a completed video.
On success, read the output URLs from generation.result.assets. On failure, inspect the public error_code and error_message.
Retries of an unchanged creation request should reuse the original Idempotency-Key. An idempotent replay can return an already-completed task.

Callbacks

Manage the secret used to verify generation webhook signatures. Callback URLs are supplied when you create each generation.

Webhook flow

Callback URL per generation.

Webhook signing key

Code Examples

Request

const response = await fetch("https://api.seeapi.com/v1/templates/christmas-dance-trend/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Idempotency-Key": "template-order-001",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "provider": "seeapi",
  "input": {
    "reference_images": [
      "https://example.com/person-left.jpg",
      "https://example.com/person-right.jpg"
    ],
    "resolution": "720p",
    "aspect_ratio": "9:16",
    "seed": 0
  }
})
});

const result = await response.json();

ResponseHTTP 202

{
  "generation": {
    "id": "task_example",
    "template_id": "christmas-dance-trend",
    "provider": "seeapi",
    "input": {
      "reference_images": [
        "https://example.com/person-left.jpg",
        "https://example.com/person-right.jpg"
      ],
      "resolution": "720p",
      "aspect_ratio": "9:16",
      "seed": 0
    },
    "status": "processing",
    "estimated_credits": 10,
    "consumed_credits": 0,
    "refunded_credits": 0,
    "created_at": "2026-01-01T00:00:00.000Z",
    "updated_at": "2026-01-01T00:00:00.000Z"
  },
  "idempotent": false
}

const response = await fetch("https://api.seeapi.com/v1/templates/christmas-dance-trend/generations", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Idempotency-Key": "template-order-001", "Content-Type": "application/json" }, body: JSON.stringify({ "provider": "seeapi", "input": { "reference_images": [ "https://example.com/person-left.jpg", "https://example.com/person-right.jpg" ], "resolution": "720p", "aspect_ratio": "9:16", "seed": 0 } }) }); const result = await response.json();

{ "generation": { "id": "task_example", "template_id": "christmas-dance-trend", "provider": "seeapi", "input": { "reference_images": [ "https://example.com/person-left.jpg", "https://example.com/person-right.jpg" ], "resolution": "720p", "aspect_ratio": "9:16", "seed": 0 }, "status": "processing", "estimated_credits": 10, "consumed_credits": 0, "refunded_credits": 0, "created_at": "2026-01-01T00:00:00.000Z", "updated_at": "2026-01-01T00:00:00.000Z" }, "idempotent": false }

Responses

202Generation accepted. Poll GET /v1/generations/{task_id} for results; acceptance is not completion.

Bodyapplication/json

objectrequired

stringrequired

Example:: task_example

stringrequired

Public template ID.

Example:: christmas-dance-trend

stringrequired

Allowed:seeapi

Example:: seeapi

objectrequired

Normalized customer input only.

Example:: {"reference_images":["https://customer.example.com/input-1.jpg","https://customer.example.com/input-2.jpg"],"resolution":"720p","aspect_ratio":"9:16","seed":0}

stringrequired

Allowed:processing

numberrequired

Request-specific template estimate in customer credits; obtain an estimate with Quote Template. The example value is illustrative, not this template's price.

Example:: 10

numberrequired

Example:: 0

numberrequired

Example:: 0

string <date-time>required

Example:: 2026-01-01T00:00:00.000Z

string <date-time>required

Example:: 2026-01-01T00:00:00.000Z

booleanrequired

Allowed:false

Example:: false

200Idempotent replay with the task's current status, recorded credits, and available result or public error. The task may already be completed.

Bodyapplication/json

objectrequired

stringrequired

Public template ID.

Example:: christmas-dance-trend

stringrequired

Allowed:seeapi

Example:: seeapi

objectrequired

Normalized customer input only.

stringrequired

Allowed:processingsucceededfailedcanceledrefundedexpired

numberrequired

Estimate recorded on the original task in customer credits.

numberrequired

objectoptional

array <object>required

stringrequired

Allowed:imagevideo

string <uri>required

stringrequired

integerrequired

stringoptional

string <date-time>required

string <date-time>optional

booleanrequired

Allowed:true

Example:: true

400

Invalid request or public template input

401

Invalid API key

402

Insufficient credits

403

API key scope or access denied

404

Template or task not found or unavailable

409

Template configuration changed, idempotency conflict, or request still being created

413

Request body too large

429

Rate limit exceeded

503

Service temporarily unavailable