Seedance 2 API Examples for PoYo

Focused server-side examples for building with seedance-2 and seedance-2-fast on PoYo.

Model Page | Docs | Get API Key | Pricing | Main Examples

Seedance 2 is useful for product clips, short social videos, reference-driven video, and motion ideas where optional generated audio can be part of the first draft.

Sample output: PoYo model page sample.

This is an official PoYo model page sample, not a file generated by this repo.

What This Repo Covers

• Text-to-video with seedance-2
• Faster generation path with seedance-2-fast
• cURL and Node.js backend examples
• Async task flow: submit, store data.task_id, poll status, retrieve files
• Webhook receiver notes for production callbacks
• Prompt examples and production integration notes

Quick Start

cp .env.example .env
# Edit .env and set POYO_API_KEY

Run the Node.js example:

cd node
npm start

Keep POYO_API_KEY on the server. Do not expose it in browser code, mobile apps, screenshots, or public logs.

API Flow

Submit a video task:

POST https://api.poyo.ai/api/generate/submit
Authorization: Bearer <POYO_API_KEY>
Content-Type: application/json

Store the returned data.task_id, then poll:

GET https://api.poyo.ai/api/generate/status/{task_id}
Authorization: Bearer <POYO_API_KEY>

For production queues, pass callback_url during submit and use a webhook receiver for terminal task updates.

Generate

{
  "model": "seedance-2",
  "input": {
    "prompt": "A short product teaser for a matte black electric kettle. Steam rises slowly, morning light enters from the window, camera pushes in, subtle kitchen ambience",
    "resolution": "720p",
    "duration": 8,
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}

Fast Draft Request

Use seedance-2-fast when you want a quicker draft before spending more time on final video iterations.

{
  "model": "seedance-2-fast",
  "callback_url": "https://example.com/api/poyo/webhook",
  "input": {
    "prompt": "A quick product motion draft for a matte black electric kettle. Steam rises slowly, camera pushes in, subtle kitchen ambience",
    "resolution": "720p",
    "duration": 8,
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}

Examples

Path	What it covers
curl/generate.md	Copy-paste submit and status requests.
node/	Native Node.js submit and poll flow.
webhooks/express-webhook/	Minimal Express receiver for PoYo callbacks.
docs/prompt-examples.md	Practical prompts for product workflows and creative tests.
docs/production-notes.md	Security and reliability notes before launch.

Expected Submit Response

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "not_started",
    "created_time": "2026-05-23T08:00:00"
  }
}

Expected Status Response

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "finished",
    "progress": 100,
    "files": [
      {
        "file_url": "https://storage.poyo.ai/generated/video.mp4",
        "file_type": "video"
      }
    ],
    "error_message": null
  }
}

Production Checklist

• Keep POYO_API_KEY server-side only.
• Validate prompts and source media URLs before submit.
• Store data.task_id before polling or waiting for webhooks.
• Treat finished and failed as terminal states.
• Log task IDs and status transitions, not API keys or private prompts.
• Make webhook handlers idempotent.
• Download returned files before they expire.
• Check current model availability and cost on the PoYo model page.

Run Checks

make check

On Windows:

./scripts/check.ps1

License

MIT