---
title: "Create once using an idempotency key / 使用幂等键提交"
method: POST
path: "/videos/generations"
---

# Create once using an idempotency key / 使用幂等键提交

`POST /videos/generations`

## Request

- Base URL: `https://clipmivoai.com/api/open/v1`
- URL: `https://clipmivoai.com/api/open/v1/videos/generations`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, required

## Request body

- GenerationRequest: Media URLs must resolve to same-origin owned assets. Callbacks require registration, verification and enabled dispatch; hosted acceptance is pending. Defaults vary by model. / 媒体URL须对应同源本人素材；回调需先注册、验证并启用调度，线上验收待完成。默认值因模型而异。
  - `model` string, required: Exact workflow ID from GET models; supported fields vary by model. / 使用模型目录中的完整工作流ID。
  - `prompt` string
  - `duration` number: Use the selected model/mode/quality duration list. / 按对应模型和清晰度选择。
  - `quality` string
  - `aspect_ratio` string
  - `generate_audio` boolean
  - `image_urls` string[]
  - `video_urls` string[]
  - `audio_urls` string[]
  - `metadata` object
  - `quoted_credits` number
  - `callback_url` string, uri: Exact URL of a verified endpoint owned by this account; requires a healthy callback worker. / 本账户已验证端点地址，需要回调后台正常运行。
  - `seed` integer
  - `negative_prompt` string
  - `watermark` boolean
  - `edit_audio` 'auto' | 'origin'
  - `media_roles` object

## Response `202`

Accepted, not completed / 已接收，尚未完成

- object
  - `success` unknown, required
  - `request_id` string, required
  - `data` Task, required
    - `id` string, required
    - `object` 'video.generation.task', required
    - `model` string, required
    - `status` 'queued' | 'processing' | 'succeeded' | 'failed' | 'needs_review', required
    - `created` integer, required
    - `task_info` object, required
      - `can_cancel` unknown
      - `needs_review` boolean
    - `usage` object, required
      - `billing_rule` 'total_tokens' | 'quoted_credits', required: Settlement basis, not a per-second guarantee. / 结算依据，不表示按秒收费。
      - `credits_reserved` integer, required: Original reservation before settlement. / 结算前的原始预留点数。
      - `credits_settled` integer, required: Final charge after successful settlement. / 成功结算后的实际扣除点数。
      - `credits_refunded` integer, required: Credits returned to original lots, which retain their expiry and restrictions. / 退回原点数批次，保留其有效期及限制。
    - `result` object, nullable, required
      - `download_url` string, required
      - `requires_authentication` unknown, required
    - `error` object, nullable, required
      - `code` string, required
    - `metadata` object, required

## Other responses

- `400`: Request rejected / 请求被拒绝
- `401`: Request rejected / 请求被拒绝
- `403`: Request rejected / 请求被拒绝
- `404`: Request rejected / 请求被拒绝
- `409`: Request rejected / 请求被拒绝
- `413`: Request rejected / 请求被拒绝
- `422`: Request rejected / 请求被拒绝
- `429`: Request rejected / 请求被拒绝
- `503`: Request rejected / 请求被拒绝

---

[API](https://skmtc.dev/clipmivoai/apis/clipmivoai-api.md) · [All operations](https://skmtc.dev/clipmivoai/apis/clipmivoai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clipmivoai/apis/clipmivoai-api/revisions/6e6d5f5a84a7?raw)