# Seedance 1.0 Pro Fast

> ByteDance's fast video model for silent 720p generation from a prompt or a starting image.

- Model page: https://yir.ai/models/seedance-1-pro-fast
- Model ID: `bytedance/seedance-1.0-pro-fast`
- Billing: by the channel that ran the job; attempts the upstream did not bill are free.

## Pricing

Current public prices by channel for the same output specification; official prices are a reference. You are billed by the channel that actually runs the job, which may change on failover.

| Output specification | Channel | Public price |
|---|---|---|
| Uniform specification | ByteDance (official) | $0.0206 / second |

## Parameters

- Operation: `generate_video`

| Parameter | Values | Default |
|---|---|---|
| `input` | text / image | text |
| `resolution` | 720p | 720p |
| `aspect_ratio` | 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 | 16:9 |
| `duration` | 2 / 3 / 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 | 5 |

## Integration

Pick either: the official SDK for new code, or swap the Base URL in projects already using the OpenAI protocol.

### Official SDK (TypeScript)

The SDK calls the Standard API (https://gateway.yir.ai) to submit, wait for and collect jobs; a Go SDK is also available. https://yir.ai/docs/integrations/sdk

```bash
pnpm add @yir-ai/sdk
```

```ts
import { createNodeYirClient } from "@yir-ai/sdk/server";

// Reads YIR_API_KEY from the environment by default: process.env.YIR_API_KEY
const client = createNodeYirClient();

// 1. Submit a video generation job
const job = await client.submitVideo({
  model: "bytedance/seedance-1.0-pro-fast",
  input: {
    type: "text",
    prompt: "A sea turtle swims slowly over a coral reef. The camera tracks smoothly from the side as sunlight filters through clear water, casting moving patterns across its shell",
  },
  parameters: {
    duration: 5,
    resolution: "720p",
    aspect_ratio: "16:9",
    generate_audio: false,
    n: 1,
  },
});

// 2. Wait for the job to finish and deliver its result
const result = await client.waitForJob(job.id);
console.log("Delivered files:", result.result);
if (result.result && "files" in result.result) {
  for (const file of result.result.files) {
    console.log("->", file.url);
  }
}
```

### OpenAI-compatible API

OpenAI Images and Sora Videos protocols for OpenAI SDKs and gateways such as new-api; no chat. https://yir.ai/docs/integrations/openai-compatibility

- OpenAI SDK base_url: `https://gateway.yir.ai/openai/v1`
- new-api channel Base URL (channel type OpenAI): `https://gateway.yir.ai/openai`
- Model ID: `bytedance/seedance-1.0-pro-fast`

```bash
curl https://gateway.yir.ai/openai/v1/videos \
  -H "Authorization: Bearer $YIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-1.0-pro-fast",
    "prompt": "A sea turtle swims slowly over a coral reef. The camera tracks smoothly from the side as sunlight filters through clear water, casting moving patterns across its shell",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "seconds": "5"
  }'
```

## FAQ

### Does Seedance 1.0 Pro Fast have an official API?

Yes. ByteDance sells Seedance 1.0 Pro Fast through its own official API, and its list price is shown as the official reference in the table above. Through Yir you call Seedance 1.0 Pro Fast with one API key and compare it with every provider's public price.

## Rules

- Authenticate with Authorization: Bearer $YIR_API_KEY; keep the key in a server environment variable, never in browser code, source control, prompts or logs.
- Jobs are asynchronous: keep the Job ID, wait for a terminal state, then read the result; handle failure and cancellation.
- For safe retries, reuse the same idempotency key and request; do not blindly resubmit when the result is unknown.
- Result URLs are temporary; copy files elsewhere if you need to keep them.

## Links

- [Quickstart](https://yir.ai/docs/getting-started/quickstart)
- [API reference](https://yir.ai/docs/reference)
- [llms.txt](https://yir.ai/llms.txt)
