> ## Documentation Index > Fetch the complete documentation index at: https://docs.mountsea.ai/llms.txt > Use this file to discover all available pages before exploring further. # Veo 3 - Image to Video ## OpenAPI ````yaml mountsea-api.mint.json POST /ms/v1/run/google/veo-3/image-to-video openapi: 3.0.0 info: title: mountsea-api description: >- mountsea unified AI API — video, image, and audio generation. ### Async task flow 1. `POST /ms/v1/run/{endpoint_slug}` — submit a job (returns Task with `status: queued`). 2. `GET /ms/v1/tasks/{task_id}` — poll until `succeeded` (`output.images` / `output.videos` / `output.audio`) or `failed`/`timeout` (`error`). Or pass `webhook_url` in the submit body for a signed terminal callback (`x-ms-signature`). 3. `GET /ms/v1/endpoints[/{slug}]` — marketplace listing with `input_schema`, `output_schema`, and `examples`. ### Request body - `{ "input": { ... } }` — all parameters and media URLs per endpoint `input_schema`. - Optional `webhook_url` for callbacks. ### SDK compatibility (optional) Prefer the native async API above? Skip this section. - **OpenAI SDK** — `baseURL = https://{gateway}/ms/v1` - Image (sync): `POST /ms/v1/images/generations|edits` — gpt-image-2 family - Video (async): `POST /ms/v1/videos` + `GET /ms/v1/videos/{id}` — sora-2 → Veo lite/pro slugs - **Gemini SDK** — `httpOptions.baseUrl = https://{gateway}/ms` - Image (sync): `POST /ms/v1beta/models/{model}:generateContent` — nano-banana family - Video (async): `POST /ms/v1beta/models/{model}:predictLongRunning` + poll `GET /ms/v1beta/operations/{task_id}` Unsupported `model` → **HTTP 400** before any task is created (no charge). Successful calls bill the **same endpoint slug** as the equivalent `/ms/v1/run/...` API. version: 1.0.0 contact: {} servers: - url: https://api.mountsea.ai description: API Gateway security: [] tags: - name: Run description: Submit async tasks by endpoint slug - name: Tasks description: Poll or cancel tasks - name: Endpoints (marketplace) description: Endpoint catalog and schemas - name: SDK Compatibility description: >- OpenAI / Gemini official SDK — sync image APIs (same billing as native run) - name: Admin - Catalog (internal) description: Internal admin (swagger only, not public gateway) paths: /ms/v1/run/google/veo-3/image-to-video: post: tags: - Models / video summary: Veo 3 - Image to Video description: >- Google Veo 3 single-image animation. **Endpoint**: `google/veo-3/image-to-video` · **mode**: `image-to-video` Returns a Task with `status: queued` and `output: null`. Poll `GET /ms/v1/tasks/{task_id}` until `succeeded`, then read `output` (see response schema). Request examples are taken from the endpoint `examples` field. operationId: run_google_veo_3_image_to_video requestBody: required: true content: application/json: schema: $ref: >- #/components/schemas/RunEndpointInput_google_veo_3_image_to_video example: input: prompt: Animate. duration: 8s image_url: https://example.com/a.jpg responses: '200': $ref: '#/components/responses/MsTaskVideoResponse' '201': $ref: '#/components/responses/MsTaskVideoResponse' '400': $ref: '#/components/responses/BadRequestResponse' '404': $ref: '#/components/responses/NotFoundResponse' security: - bearerAuth: [] components: schemas: RunEndpointInput_google_veo_3_image_to_video: type: object properties: input: type: object description: >- Parameters for this endpoint (input_schema.params). Input media URLs use schema field names, e.g. image_url, image_urls, mask_url. properties: seed: description: Optional random seed for reproducibility. type: integer prompt: description: Text prompt for video generation. Maximum 4000 characters. type: string maxLength: 4000 auto_fix: type: boolean duration: type: string enum: - 4s - 6s - 8s default: 8s image_url: description: Input image URL to animate (JPEG/PNG/WebP). type: string format: uri resolution: type: string enum: - 720p - 1080p default: 720p aspect_ratio: type: string enum: - auto - '16:9' - '9:16' default: auto generate_audio: type: boolean default: true negative_prompt: description: Negative prompt. Maximum 2000 characters. type: string maxLength: 2000 safety_tolerance: type: string enum: - '1' - '2' - '3' - '4' - '5' - '6' default: '4' required: - prompt - image_url webhook_url: type: string format: uri description: >- Optional webhook URL for terminal status (HMAC header x-ms-signature) MsTaskVideo: type: object description: Async video task properties: task_id: type: string example: ms-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx endpoint: type: string example: google/veo-3.1/text-to-video model: type: string example: veo-3.1 capability: type: string enum: - image - video - audio mode: type: string example: text-to-video status: type: string enum: - queued - processing - succeeded - failed - timeout - canceled error: type: object nullable: true properties: code: type: integer example: 500 message: type: string example: task failed created_at: type: string format: date-time started_at: type: string format: date-time nullable: true completed_at: type: string format: date-time nullable: true elapsed_ms: type: integer nullable: true output: nullable: true description: >- Normalized task output. Null while queued/processing; populated when status=succeeded. allOf: - $ref: '#/components/schemas/MsTaskOutputVideo' required: - task_id - endpoint - model - capability - mode - status - created_at ErrorBody: type: object properties: statusCode: type: integer example: 400 message: type: string error: type: string MsTaskOutputVideo: type: object description: 'Succeeded task output: single video URL per task.' properties: videos: type: array description: Generated videos (typically one item) items: type: object properties: url: type: string format: uri description: Stable mountsea CDN URL required: - url required: - videos responses: MsTaskVideoResponse: description: Video task (usually queued right after submit) content: application/json: schema: $ref: '#/components/schemas/MsTaskVideo' BadRequestResponse: description: Validation failed or unsupported model content: application/json: schema: $ref: '#/components/schemas/ErrorBody' NotFoundResponse: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorBody' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````