docs
Base URL https://rendermate.tella.dev/v1. Authenticate with Authorization: Bearer sk_…, a key from the dashboard. Agents: the same content as Markdown is at /llms.txt.
■ quickstart
curl https://rendermate.tella.dev/v1/generations \
-H "Authorization: Bearer $RENDERMATE_API_KEY" \
--json '{
"model": "bytedance/seedance-2.5",
"prompt": "a paper boat drifting down a rainy street, macro lens",
"resolution": "1080p",
"ratio": "9:16",
"duration": 5,
"generateAudio": true
}'
# → { "id": "gen_8f2k…", "status": "queued" }
# poll GET /generations/gen_8f2k… →
# { "status": "done", "assetId": "as_q7…",
# "usage": { "completionTokens": 243000 } }curl https://rendermate.tella.dev/v1/compositions \
-H "Authorization: Bearer $RENDERMATE_API_KEY" \
--json '{
"canvas": { "width": 1080, "height": 1920, "fps": 30, "durationMs": 5000 },
"layers": [
{ "type": "media", "assetId": "as_q7…", "fit": "cover" },
{ "type": "text", "text": "Rainy day sale", "y": 0.8,
"animate": { "in": "rise", "durationMs": 400 } }
]
}'
# → { "id": "cmp_31x…", "revision": 1 }curl https://rendermate.tella.dev/v1/renders \
-H "Authorization: Bearer $RENDERMATE_API_KEY" \
--json '{ "compositionId": "cmp_31x…", "format": "mp4", "publish": true }'
# → { "id": "rnd_m2…", "status": "done",
# "url": "https://rendermate.tella.dev/files/rnd_m2….mp4",
# "playbackUrl": "https://rendermate.tella.dev/v/vid_a9…" }■ mcp
{
"mcpServers": {
"rendermate": {
"url": "https://rendermate.tella.dev/mcp",
"headers": { "Authorization": "Bearer ${RENDERMATE_API_KEY}" }
}
}
}■ /assets
Upload or import any media. Stored, probed, transcoded for playback.
| POST | /assets | Create an upload; returns a presigned PUT URL |
| POST | /assets/imports | Import from a URL (mp4, mov, YouTube, image, audio) |
| GET | /assets/{id} | Status, duration, dimensions, playbackUrl |
| GET | /assets/{id}/transcript | Words with start/end ms |
| DELETE | /assets/{id} | Delete an asset and its renditions |
■ /generations
One endpoint, every model and every provider parameter. Results land as assets; you pay the provider's price for what was used.
| GET | /models | Every routable model with its price |
| POST | /generations | {model, prompt, …model params} → generation |
| GET | /generations/{id} | Status, assetId, and usage: tokens and USD billed |
■ /compositions
Freeform timeline JSON: tracks, layers, keyframes, text, transitions.
| POST | /compositions | Create from a document or an empty canvas |
| POST | /compositions/{id}/commands | Apply edits (add layer, trim, animate…) |
| GET | /compositions/{id} | The current document |
| GET | /compositions/schema | JSON schema for documents and commands |
■ /renders
GPU compositing to MP4 or HLS. Same engine for preview and export.
| POST | /renders | {compositionId, format, resolution} → render |
| GET | /renders/{id} | Progress, then url + playbackUrl |
■ /videos
A hosted, playable URL for any asset or render. Embed it anywhere.
| POST | /videos | Publish an asset or render → playbackUrl, embedUrl |
| GET | /videos/{id} | Playback URLs, thumbnail, captions |
| GET | /videos/{id}/analytics | Views and watch time |
■ /account
Metered usage and webhooks.
| GET | /account | Which organization a key belongs to |
| GET | /usage | Usage per meter for a date range |
| POST | /webhooks/endpoints | Get called when renders and generations finish |
■ bytedance/seedance · parameters + billing
Every BytePlus parameter is supported on POST /generations. You pay what BytePlus charges for the task, with 0% markup: the tokens it reports (usage.completionTokens on the generation) times the model's price per million. Tokens are about width × height × 24 × seconds / 1024 of the output, so size and length set the price.
| prompt | string | What to generate. Put dialogue in double quotes for spoken audio. (content text) |
| resolution | "480p" | "720p" | "1080p" | "4k" | Output resolution; default 720p. 1080p on 2.5 and 2.0, 4k on 2.0 only. (resolution) |
| ratio | "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "adaptive" | Aspect ratio; default adaptive (picked from the prompt or inputs). First-frame, edit and extend tasks on 2.5 accept only adaptive. (ratio) |
| duration | integer | Seconds: 4–30 on 2.5, 4–15 on 2.0 models, or -1 to let the model choose. (duration) |
| generateAudio | boolean | Synchronised voice, effects and music; default true. Mono. (generate_audio) |
| inputs | Array<{role, assetId}> | Media to condition on, by asset id. role: first_frame, last_frame (image-to-video), or reference_image (2.5: up to 30, 2.0: up to 9), reference_video, reference_audio (omni reference). Frame roles and reference roles cannot be mixed. 2.0 needs an image or video beside reference_audio. (content image_url / video_url / audio_url + role) |
| draft | boolean | 2.5 only: a cheap 480p draft to check shots and motion before the final. (draft) |
| draftId | string | 2.5 only: render the final video from a draft generation's id. (content draft_task) |
| returnLastFrame | boolean | Also save the last frame as an image asset, to chain clips with first_frame. (return_last_frame) |
| outputFormat | "mp4" | "mov" | mov keeps more colour precision for grading and keying; default mp4. (output_format) |
| watermark | boolean | Burn in an "AI Generated" mark; default false. (watermark) |
| expiresAfterSeconds | integer | Give up if not finished in time: 3600–259200, default 172800. (execution_expires_after) |
| providerOptions | object | Any other BytePlus task field, sent as-is, so new parameters work on day one. |
| model | resolutions | seconds | per 1M tokens |
|---|---|---|---|
| bytedance/seedance-2.5 | 480p, 720p, 1080p | 4–30 | $11.70 |
| bytedance/seedance-2.0 | 480p, 720p, 1080p, 4k | 4–15 | $7.70 |
| bytedance/seedance-2.0-fast | 480p, 720p | 4–15 | $5.60 |
| bytedance/seedance-2.0-mini | 480p, 720p | 4–15 | $3.50 |
| output size (2.0 series) | 16:9 | 4:3 | 1:1 | 3:4 | 9:16 | 21:9 |
|---|---|---|---|---|---|---|
| 480p | 864×496 | 752×560 | 640×640 | 560×752 | 496×864 | 992×432 |
| 720p | 1280×720 | 1112×834 | 960×960 | 834×1112 | 720×1280 | 1470×630 |
| 1080p | 1920×1080 | 1664×1248 | 1440×1440 | 1248×1664 | 1080×1920 | 2206×946 |
| 4k | 3840×2160 | 3326×2494 | 2880×2880 | 2494×3326 | 2160×3840 | 4398×1886 |
2.5 is the same except 480p 16:9 and 9:16, which are 854×480 and 480×854. Tasks with a reference video bill at BytePlus' video-input token price.
■ models
| bytedance/seedance-2.5 | video | best quality, video edit + extend, up to 30 s; ≈ $0.569/s at 1080p 16:9 |
| bytedance/seedance-2.0 | video | up to 4K; ≈ $1.497/s at 4k 16:9 |
| bytedance/seedance-2.0-fast | video | quicker, up to 720p; ≈ $0.121/s at 720p 16:9 |
| bytedance/seedance-2.0-mini | video | cheapest, up to 720p; ≈ $0.076/s at 720p 16:9 |
| openai/gpt-image | image | reference-image aware |
| elevenlabs/sound-effects | audio | prompt → SFX |
| elevenlabs/tts | speech | voices + cloning |
| assemblyai/universal | transcription | word-level timings |