Video Generation Tasks

API Overview

Video generation is an asynchronous operation:

1. Call POST /v1/videos/tasks to submit a task
2. Save the public task ID from the response
3. Call GET /v1/tasks/{task_id} to query status and results

The Base URL is https://api.rokoapi.com/v1. All requests must include Authorization: Bearer $API_KEY.

Supported Models

Actual availability is subject to /v1/models, console channel configuration, and the key’s assigned group. Users select product models only; RokoAPI automatically selects EvoLink’s text-to-video, image-to-video, reference-to-video, or editing routes based on generation_type and asset fields to automatically select EvoLink text-to-video, image-to-video, reference-to-video, or editing routes.

Text-to-Video

curl https://api.rokoapi.com/v1/videos/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "generation_type": "text",
    "prompt": "A cinematic sunrise over snow mountains",
    "duration": 8,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

Image-to-Video and Reference-to-Video

Assets are typically passed via image_urls, video_urls and audio_urls as publicly downloadable URLs:

{
  "model": "seedance-2.0",
  "generation_type": "reference",
  "prompt": "Keep the character identity and create a slow camera orbit",
  "image_urls": ["https://example.com/character.png"],
  "video_urls": ["https://example.com/motion.mp4"],
  "duration": 6,
  "quality": "720p",
  "aspect_ratio": "16:9"
}

Exception: Wan 2.7 image-to-video uses image_start and optionally image_end; Grok 1.5 automatically selects the mode based on the number of image_urls (0 for text-to-video, 1 for image-to-video, 2–7 for reference-to-video) and does not accept aspect_ratio.

Video Editing

{
  "model": "wan-2.7",
  "generation_type": "edit",
  "prompt": "Change the background to a rainy neon street",
  "video_urls": ["https://example.com/input.mp4"],
  "image_urls": ["https://example.com/style.png"],
  "duration": 0,
  "quality": "720p"
}

In Wan 2.7 editing, duration: 0 indicates following the input video. Gemini Omni editing follows the input video; do not send duration or aspect_ratio.

Parameter Limits

Additional model parameters in the request are passed through to EvoLink in their original JSON structure, including negative_prompt, generate_audio, content_filter, sound, prompt_extend and model_params. RokoAPI first validates known boundaries such as duration, quality, aspect ratio, asset count, and callback URL. The video endpoint does not support n.

Callbacks and Queries

The optional callback_url must be a public HTTPS URL, up to 2048 characters long, and cannot point to localhost or a private IP. Even with a callback configured, it is recommended to keep polling as a fallback:

curl https://api.rokoapi.com/v1/tasks/task_public_id \
  -H "Authorization: Bearer $API_KEY"

Common statuses include queued, in_progress, completed and failed. Result links may have an expiration time; in production, download and store them promptly.

Billing

Models use a unified v2 USD expression for billing, combining output duration, input reference video duration, input image count, audio toggle, resolution, quality, generation method, and token usage in a single formula. A pre-charge is applied at submission based on validated parameters; final settlement occurs after task completion based on actual token usage or output duration.

The following is a fixed price snapshot as of 2026-08-20, including a 10% service fee on EvoLink’s published cost price. All amounts are in USD. Prices do not change in real time with upstream credits; the table and backend expressions are updated only after admin review of upstream price adjustments.

Seedance 2.0 Series

The promotional prices for Fast and Mini are based on EvoLink’s 2026-08-07 price adjustment. After the promotion ends, RokoAPI prices will not change automatically; the new snapshot approved in the backend will apply.

Other Per-Second Video Models

Kling O3 is billed by both resolution and audio toggle:

Sora 2 Series

Gemini Omni Token Pricing

Reference video duration is included in final billing only after the system completes media metadata validation or obtains a trusted usage estimate. For full pricing, see the Pricing page and the current configuration in your dashboard. For upstream pricing sources, refer to the EvoLink model catalog and each model’s developer page.