{"id":"83c7d36c-1816-4b83-a024-246835af388e","shortId":"8EF3PK","kind":"skill","title":"sora-video","tagline":"Generate AI videos with OpenAI Sora via AceDataCloud API. Use when creating videos from text prompts, generating videos from reference images, or using character references from existing videos. Supports text-to-video, image-to-video, and character-driven generation with multiple","description":"# Sora Video Generation\n\nGenerate AI videos through AceDataCloud's OpenAI Sora API.\n\n> **Setup:** See [authentication](../_shared/authentication.md) for token setup.\n\n## Quick Start\n\n```bash\ncurl -X POST https://api.acedata.cloud/sora/videos \\\n  -H \"Authorization: Bearer $ACEDATACLOUD_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"prompt\": \"a golden retriever running on a beach at sunset\", \"model\": \"sora-2\", \"callback_url\": \"https://api.acedata.cloud/health\"}'\n```\n\n> **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /sora/tasks` with `{\"task_id\": \"...\"}`.\n\n## Models\n\n| Model | Duration | Quality | Best For |\n|-------|----------|---------|----------|\n| `sora-2` | 10–15s | Standard | Most tasks (default) |\n| `sora-2-pro` | 10–25s | Higher | Premium quality, longer videos |\n\n## Workflows\n\n### 1. Text-to-Video\n\n```json\nPOST /sora/videos\n{\n  \"prompt\": \"a busy Tokyo street at night with neon signs reflecting in rain puddles\",\n  \"model\": \"sora-2\",\n  \"size\": \"small\",\n  \"duration\": 10,\n  \"orientation\": \"landscape\"\n}\n```\n\n### 2. Image-to-Video\n\nUse reference images to guide generation.\n\n```json\nPOST /sora/videos\n{\n  \"prompt\": \"the scene gradually comes alive with gentle motion\",\n  \"image_urls\": [\"https://example.com/scene.jpg\"],\n  \"model\": \"sora-2\",\n  \"orientation\": \"landscape\"\n}\n```\n\n### 3. Character-Driven Video\n\nExtract a character from an existing video and use them in a new scene.\n\n```json\nPOST /sora/videos\n{\n  \"prompt\": \"the character walks through a futuristic city\",\n  \"character_url\": \"https://example.com/source-video.mp4\",\n  \"character_start\": 2.0,\n  \"character_end\": 5.0,\n  \"model\": \"sora-2-pro\"\n}\n```\n\n## Parameters\n\n| Parameter | Values | Description |\n|-----------|--------|-------------|\n| `model` | `\"sora-2\"`, `\"sora-2-pro\"` | Model to use (required) |\n| `size` | `\"small\"`, `\"large\"` | Video resolution |\n| `duration` | `10`, `15`, `25` | Duration in seconds (25 only with sora-2-pro) |\n| `orientation` | `\"landscape\"` (16:9), `\"portrait\"` (9:16), `\"square\"` (1:1) | Video orientation |\n| `version` | `\"1.0\"` | API version — version `1.0` enables duration up to 25s, orientation, character references, and image inputs |\n\n## Gotchas\n\n- Duration of **25 seconds** is only available with `sora-2-pro` model\n- `size: \"large\"` produces higher resolution but costs more and takes longer\n- Character-driven generation requires `character_start` and `character_end` timestamps (in seconds) from the source video\n- `orientation` sets the aspect ratio — use `\"portrait\"` for mobile-first content\n- Task states use `\"succeeded\"` (not \"completed\") — check for this value when polling\n\n> **MCP:** `pip install mcp-sora` | Hosted: `https://sora.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)","tags":["sora","video","skills","acedatacloud","acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code"],"capabilities":["skill","source-acedatacloud","skill-sora-video","topic-acedata-cloud","topic-agent-skills","topic-agentskills","topic-ai-image","topic-ai-music","topic-ai-tools","topic-ai-video","topic-claude-code","topic-cursor","topic-gemini-cli","topic-github-copilot","topic-mcp"],"categories":["Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/AceDataCloud/Skills/sora-video","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add AceDataCloud/Skills","source_repo":"https://github.com/AceDataCloud/Skills","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (2,781 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:03.915Z","embedding":null,"createdAt":"2026-05-18T13:21:34.934Z","updatedAt":"2026-05-18T19:14:03.915Z","lastSeenAt":"2026-05-18T19:14:03.915Z","tsv":"'-2':100,126,134,168,205,251,259,261,283,324 '/_shared/async-tasks.md':111 '/_shared/authentication.md':63 '/_shared/mcp-servers.md':393 '/health':105 '/mcp':388 '/scene.jpg':202 '/sora/tasks':115 '/sora/videos':75,151,188,229 '/source-video.mp4':242 '1':144,293,294 '1.0':298,302 '10':127,136,172,273 '15':274 '15s':128 '16':287,291 '2':175 '2.0':245 '25':275,279,317 '25s':137,307 '3':208 '5.0':248 '9':288,290 'acedatacloud':11,55,79 'ai':5,52 'aliv':194 'api':12,59,80,299 'api.acedata.cloud':74,104 'api.acedata.cloud/health':103 'api.acedata.cloud/sora/videos':73 'application/json':86 'aspect':358 'async':106,108 'authent':62 'author':77 'avail':321 'bash':69 'beach':95 'bearer':78 'best':123 'busi':154 'callback':101 'charact':27,43,210,215,232,238,243,246,309,339,343,346 'character-driven':42,209,338 'check':373 'citi':237 'come':193 'complet':372 'content':84,366 'content-typ':83 'cost':333 'creat':15 'curl':70 'd':87 'default':132 'descript':256 'driven':44,211,340 'durat':121,171,272,276,304,315 'enabl':303 'end':247,347 'example.com':201,241 'example.com/scene.jpg':200 'example.com/source-video.mp4':240 'exist':30,218 'extract':213 'first':365 'futurist':236 'generat':4,20,45,50,51,185,341 'gentl':196 'golden':90 'gotcha':314 'gradual':192 'guid':184 'h':76,82 'higher':138,330 'host':385 'id':118 'imag':24,38,177,182,198,312 'image-to-video':37,176 'input':313 'instal':381 'json':149,186,227 'landscap':174,207,286 'larg':269,328 'longer':141,337 'mcp':379,383,391 'mcp-sora':382 'mobil':364 'mobile-first':363 'model':98,119,120,166,203,249,257,263,326 'motion':197 'multipl':47 'neon':160 'new':225 'night':158 'openai':8,57 'orient':173,206,285,296,308,355 'paramet':253,254 'pip':380 'poll':110,112,378 'portrait':289,361 'post':72,114,150,187,228 'premium':139 'pro':135,252,262,284,325 'produc':329 'prompt':19,88,152,189,230 'puddl':165 'qualiti':122,140 'quick':67 'rain':164 'ratio':359 'refer':23,28,181,310 'reflect':162 'requir':266,342 'resolut':271,331 'retriev':91 'run':92 'scene':191,226 'second':278,318,350 'see':61,107,389 'server':392 'set':356 'setup':60,66 'sign':161 'size':169,267,327 'skill' 'skill-sora-video' 'small':170,268 'sora':2,9,48,58,99,125,133,167,204,250,258,260,282,323,384 'sora-video':1 'sora.mcp.acedata.cloud':387 'sora.mcp.acedata.cloud/mcp':386 'sourc':353 'source-acedatacloud' 'squar':292 'standard':129 'start':68,244,344 'state':368 'street':156 'succeed':370 'sunset':97 'support':32 'take':336 'task':109,117,131,367 'text':18,34,146 'text-to-video':33,145 'timestamp':348 'token':65,81 'tokyo':155 'topic-acedata-cloud' 'topic-agent-skills' 'topic-agentskills' 'topic-ai-image' 'topic-ai-music' 'topic-ai-tools' 'topic-ai-video' 'topic-claude-code' 'topic-cursor' 'topic-gemini-cli' 'topic-github-copilot' 'topic-mcp' 'type':85 'url':102,199,239 'use':13,26,180,221,265,360,369 'valu':255,376 'version':297,300,301 'via':10,113 'video':3,6,16,21,31,36,40,49,53,142,148,179,212,219,270,295,354 'walk':233 'workflow':143 'x':71","prices":[{"id":"75ca06b0-d2b5-4439-b371-cdb75e626a2e","listingId":"83c7d36c-1816-4b83-a024-246835af388e","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"AceDataCloud","category":"Skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:34.934Z"}],"sources":[{"listingId":"83c7d36c-1816-4b83-a024-246835af388e","source":"github","sourceId":"AceDataCloud/Skills/sora-video","sourceUrl":"https://github.com/AceDataCloud/Skills/tree/main/skills/sora-video","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:34.934Z","lastSeenAt":"2026-05-18T19:14:03.915Z"}],"details":{"listingId":"83c7d36c-1816-4b83-a024-246835af388e","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"AceDataCloud","slug":"sora-video","github":{"repo":"AceDataCloud/Skills","stars":7,"topics":["acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code","cursor","gemini-cli","github-copilot","mcp","npm","openai-codex","roo-code"],"license":"other","html_url":"https://github.com/AceDataCloud/Skills","pushed_at":"2026-05-18T07:35:03Z","description":"Agent Skills for AceDataCloud AI services — music, image, video generation, web search, and more. Compatible with Claude Code, GitHub Copilot, Gemini CLI, and all agentskills.io-compatible agents.","skill_md_sha":"729bdf141218d540556afc42b39a7dc733039226","skill_md_path":"skills/sora-video/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/AceDataCloud/Skills/tree/main/skills/sora-video"},"layout":"multi","source":"github","category":"Skills","frontmatter":{"name":"sora-video","license":"Apache-2.0","description":"Generate AI videos with OpenAI Sora via AceDataCloud API. Use when creating videos from text prompts, generating videos from reference images, or using character references from existing videos. Supports text-to-video, image-to-video, and character-driven generation with multiple models and resolutions.","compatibility":"Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-sora for tool-use."},"skills_sh_url":"https://skills.sh/AceDataCloud/Skills/sora-video"},"updatedAt":"2026-05-18T19:14:03.915Z"}}