API Reference

Get Video

Queries the status and result of a video generation task. Poll this endpoint until `status` is `completed` or `failed`.

GET
/api/v1/videos/{id}

Authorization

ApiKeyAuth
AuthorizationBearer <token>

Your Yolo Router API key. Format: Authorization: Bearer sk-...

In: header

Path Parameters

id*string

Task ID returned by POST /api/v1/videos.

Response Body

application/json

application/json

application/json

curl -X GET "https://api.yolorouter.com/api/v1/videos/vt_01jhx2k8mnen8xa5m0wfvyjzrp"

{
  "id": "vt_01jhx2k8mnen8xa5m0wfvyjzrp",
  "object": "video.generation",
  "status": "pending",
  "model": "<video-model-id>",
  "created_at": 1749574800,
  "estimated_cost_usd": 0.015
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_api_key",
    "message": "Invalid API key"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

Gemini Stream Generate Content POST

Generates a streaming model response using the Google Gemini API format. Compatible with the Gemini `streamGenerateContent` endpoint. Returns a Server-Sent Events stream; each `data:` frame contains a complete GeminiGenerateContentResponse JSON object. Set your Yolo Router API key via `Authorization: Bearer sk-...` or `x-goog-api-key: sk-...` header, and point the base URL to this server to use as a drop-in replacement for the Gemini SDK.

List Models GET

Returns the list of models available for your API key's group.