Enzo Fernandez Celebration API

Turn one portrait into a personalized stadium celebration inspired by Enzo Fernandez. Choose the output resolution and retrieve the finished video through the API. The result is a fictional personalized video, not real footage of the person.

Developer API pricing

Provider: SeeAPI

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

480p: 190 credits/gen (≈ $0.71/gen)

720p: 410 credits/gen (≈ $1.54/gen)

1080p: 1,010 credits/gen (≈ $3.78/gen)

4k: 2,080 credits/gen (≈ $7.79/gen)

API examples

These examples were generated through real SeeAPI API calls. Each portrait, request and output video below belongs to the same successful task. Results may vary.

Example 1

One portrait, 720p output. Task: task_2032192d7d144d12b10cfa87297a0542.

Input

Portrait photoreference_images

The single portrait supplied in this request.

Output 1

Celebration video

The generated video returned by the same successful task.

Request JSON

{
  "provider": "seeapi",
  "input": {
    "reference_images": [
      "https://static.seeapi.com/files/dfsobwrc17k1.jpg"
    ],
    "resolution": "720p"
  }
}

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

Request

POST/v1/templates/enzo-fernandez-celebration/generations

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

Header Params

stringrequired

Identifies a generation request so retries can return the existing task.

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

Example:: template-order-001

Body Params

application/json

stringrequired

Public provider identifier for this template.

Send "seeapi". Other provider values are rejected.

Allowed:seeapi

Default:: seeapi
Example:: seeapi

objectrequired

The portrait and output settings for your personalized celebration.

Submit only the public fields listed below.

string <url>required

Upload one clear portrait of a single person. One HTTPS URL. Each supplied field must contain 1–1 customer files; built-in assets do not count toward this minimum. URLs must not contain credentials or fragments.

Example:: https://customer.example.com/input-1.jpg

stringoptional

Controls the output video resolution.

Resolution affects the current template price shown above.
Use the lowercase value "4k" for 4K output.

Allowed:480p720p1080p4k

Default:: 720p
Example:: 720p

string <uri>optional

The endpoint that receives terminal generation events.

Use an absolute HTTPS URL.
Handle generation.succeeded and generation.failed, and verify webhook signatures before trusting the payload.
If omitted, query the task status instead.

Responses

202The generation was accepted for asynchronous processing.

Bodyapplication/json

HTTP 202 does not mean the video is ready.
Save generation.id and query GET /v1/generations/{task_id} until a terminal status is returned.

objectrequired

stringrequired

The task identifier used to query this generation and match callback events.

Example:: task_example

stringrequired

Public template ID.

Example:: enzo-fernandez-celebration

stringrequired

Allowed:seeapi

Example:: seeapi

objectrequired

Normalized customer input only.

Example:: {"reference_image":"https://customer.example.com/input-1.jpg","resolution":"720p"}

stringrequired

The current processing state of the generation.

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

Credits consumed by this task so far.

Example:: 0

numberrequired

Credits refunded for this task so far.

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

200An unchanged request was replayed using its original idempotency key; the existing task is returned.

Bodyapplication/json

The task may still be processing or may already have completed.
Read generation.status before using a result or handling a public error.

objectrequired

stringrequired

The task identifier used to query this generation and match callback events.

stringrequired

Public template ID.

Example:: enzo-fernandez-celebration

stringrequired

Allowed:seeapi

Example:: seeapi

objectrequired

Normalized customer input only.

stringrequired

The current processing state of the generation.

Allowed:processingsucceededfailedcanceledrefundedexpired

numberrequired

Estimate recorded on the original task in customer credits.

numberrequired

Credits consumed by this task so far.

numberrequired

Credits refunded for this task so far.

objectoptional

array <object>required

Generated assets available on the returned task.

stringrequired

Allowed:imagevideo

string <uri>required

The URL used to retrieve the generated asset.

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. Query GET /v1/generations/{task_id}; on success, retrieve the video from generation.result.assets. On failure, inspect generation.error_code and generation.error_message.

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/enzo-fernandez-celebration/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_image": "https://customer.example.com/input-1.jpg",
    "resolution": "720p"
  }
})
});

const result = await response.json();

ResponseHTTP 202

{
  "generation": {
    "id": "task_example",
    "template_id": "enzo-fernandez-celebration",
    "provider": "seeapi",
    "input": {
      "reference_image": "https://customer.example.com/input-1.jpg",
      "resolution": "720p"
    },
    "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/enzo-fernandez-celebration/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_image": "https://customer.example.com/input-1.jpg", "resolution": "720p" } }) }); const result = await response.json();

{ "generation": { "id": "task_example", "template_id": "enzo-fernandez-celebration", "provider": "seeapi", "input": { "reference_image": "https://customer.example.com/input-1.jpg", "resolution": "720p" }, "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

202The generation was accepted for asynchronous processing.

Bodyapplication/json

HTTP 202 does not mean the video is ready.
Save generation.id and query GET /v1/generations/{task_id} until a terminal status is returned.

objectrequired

stringrequired

The task identifier used to query this generation and match callback events.

Example:: task_example

stringrequired

Public template ID.

Example:: enzo-fernandez-celebration

stringrequired

Allowed:seeapi

Example:: seeapi

objectrequired

Normalized customer input only.

Example:: {"reference_image":"https://customer.example.com/input-1.jpg","resolution":"720p"}

stringrequired

The current processing state of the generation.

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

Credits consumed by this task so far.

Example:: 0

numberrequired

Credits refunded for this task so far.

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

200An unchanged request was replayed using its original idempotency key; the existing task is returned.

Bodyapplication/json

The task may still be processing or may already have completed.
Read generation.status before using a result or handling a public error.

objectrequired

stringrequired

The task identifier used to query this generation and match callback events.

stringrequired

Public template ID.

Example:: enzo-fernandez-celebration

stringrequired

Allowed:seeapi

Example:: seeapi

objectrequired

Normalized customer input only.

stringrequired

The current processing state of the generation.

Allowed:processingsucceededfailedcanceledrefundedexpired

numberrequired

Estimate recorded on the original task in customer credits.

numberrequired

Credits consumed by this task so far.

numberrequired

Credits refunded for this task so far.

objectoptional

array <object>required

Generated assets available on the returned task.

stringrequired

Allowed:imagevideo

string <uri>required

The URL used to retrieve the generated asset.

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