Goodbye 2026, Welcome 2027 API

Turn one photo into a 10-second New Year video. Your subject climbs onto a giant stone 0, stands with arms open, and the camera pulls back to reveal 2027 on a mountain summit at sunrise.

Developer API pricing

Provider: SeeAPI

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

480p: 221 credits/gen (≈ $0.83/gen)

720p: 479 credits/gen (≈ $1.79/gen)

1080p: 1,187 credits/gen (≈ $4.45/gen)

4k: 2,450 credits/gen (≈ $9.18/gen)

API examples

These examples come from real SeeAPI API calls. Each portrait and generated video below belong to the same task. All three examples use 720p output.

Example 1

Input

Climber portraitreference_image

Output 1

New Year summit video

Request JSON

{
  "provider": "seeapi",
  "input": {
    "seed": 2,
    "resolution": "720p",
    "aspect_ratio": "4:3",
    "reference_image": "https://static.seeapi.com/files/z5didqmampq7.jpg"
  }
}

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

Request

POST/v1/templates/goodbye-2026-welcome-2027/generations

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

Header Params

stringrequired

Use a unique key to identify each generation request.

Use a new key for each new generation.
Retry an unchanged request with its original key.

Example:: template-order-001

Body Params

application/json

stringrequired

Public provider identifier for this template.

Send "seeapi".

Allowed:seeapi

Default:: seeapi
Example:: seeapi

objectrequired

Photo and output settings for the New Year summit video.

Supply only the public fields listed below.
The video is 10 seconds long. Choose the output aspect ratio with aspect_ratio; the default is 9:16.

string <url>required

Photo of the person whose identity and outfit will appear in the video.

Supply exactly one photo as an accessible HTTPS image URL.
Use a clear photo of one person with an unobstructed face and visible clothing; a full-body photo is recommended.
The URL must link directly to the image and be accessible without login or authentication.
URLs must not contain credentials or fragments.
Accepted formats: JPEG, PNG, WebP, BMP, TIFF, and GIF.
The image must be smaller than 30 MB.
Width and height must each be 301–5,999 pixels.
The input image width-to-height ratio must be greater than 0.4 and less than 2.5. The output video aspect ratio is controlled separately by aspect_ratio (default: 9:16).

Example:: https://static.seeapi.com/files/4618odtk6xq9.jpeg

stringoptional

Controls the output video resolution.

Resolution affects the credit estimate shown in the dynamic pricing panel.

Allowed:480p720p1080p4k

Default:: 720p
Example:: 720p

numberoptional

Sets the seed used for video generation.

min: 0max: 999999

Default:: 0
Example:: 0

stringoptional

Controls the aspect ratio of the output video.

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

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

string <uri>optional

HTTPS endpoint for terminal generation notifications.

Use an absolute HTTPS URL.
Handle generation.succeeded and generation.failed, and verify the webhook signature before trusting the payload.

Responses

202Generation accepted. Save generation.id and poll GET /v1/generations/{task_id}; HTTP 202 does not mean the video is finished.

Bodyapplication/json

objectrequired

stringrequired

Example:: task_example

stringrequired

Public template ID.

Example:: goodbye-2026-welcome-2027

stringrequired

Allowed:seeapi

Example:: seeapi

objectrequired

Normalized customer input only.

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

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 of an existing request. Returns the task’s current status, recorded credits, and available result or public error; it may already be complete.

Bodyapplication/json

objectrequired

stringrequired

Public template ID.

Example:: goodbye-2026-welcome-2027

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

Save generation.id from the creation response. Query GET /v1/generations/{task_id} with this ID, or receive terminal notifications at your HTTPS callback_url.

Note

HTTP 202 confirms acceptance only. Wait for the terminal task status before presenting a completed video.
On success, retrieve video URLs from generation.result.assets. On failure, inspect the public error_code and error_message.
Retry the unchanged creation request with its original Idempotency-Key. HTTP 200 replays return the existing task and its current status.
The estimated_credits value in the illustrative response is not a fixed template price. Use the current template quote for the selected resolution.

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/goodbye-2026-welcome-2027/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://static.seeapi.com/files/4618odtk6xq9.jpeg",
    "resolution": "720p",
    "seed": 0,
    "aspect_ratio": "9:16"
  }
})
});

const result = await response.json();

ResponseHTTP 202

{
  "generation": {
    "id": "task_example",
    "template_id": "goodbye-2026-welcome-2027",
    "provider": "seeapi",
    "input": {
      "reference_image": "https://static.seeapi.com/files/4618odtk6xq9.jpeg",
      "resolution": "720p",
      "seed": 0,
      "aspect_ratio": "9:16"
    },
    "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/goodbye-2026-welcome-2027/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://static.seeapi.com/files/4618odtk6xq9.jpeg", "resolution": "720p", "seed": 0, "aspect_ratio": "9:16" } }) }); const result = await response.json();

{ "generation": { "id": "task_example", "template_id": "goodbye-2026-welcome-2027", "provider": "seeapi", "input": { "reference_image": "https://static.seeapi.com/files/4618odtk6xq9.jpeg", "resolution": "720p", "seed": 0, "aspect_ratio": "9:16" }, "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. Save generation.id and poll GET /v1/generations/{task_id}; HTTP 202 does not mean the video is finished.

Bodyapplication/json

objectrequired

stringrequired

Example:: task_example

stringrequired

Public template ID.

Example:: goodbye-2026-welcome-2027

stringrequired

Allowed:seeapi

Example:: seeapi

objectrequired

Normalized customer input only.

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

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 of an existing request. Returns the task’s current status, recorded credits, and available result or public error; it may already be complete.

Bodyapplication/json

objectrequired

stringrequired

Public template ID.

Example:: goodbye-2026-welcome-2027

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