---
title: "Reserve credits and submit one image; at most two unsettled tasks per account"
method: POST
path: "/images/jobs"
---

# Reserve credits and submit one image; at most two unsettled tasks per account

`POST /images/jobs`

## Request

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

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `settings` ImageSettings, required
    - `model` string, required
    - `prompt` string, required
    - `ratio` string, required
    - `resolution` string, required
    - `quality` string, required
    - `asset_ids` string[], required
  - `quoted_credits` integer, required

## Response `202`

Success / 成功

- object
  - `success` unknown, required
  - `request_id` string, required
  - `data` ImageJob, required
    - `id` string, required
    - `settings` ImageSettings, required
      - `model` string, required
      - `prompt` string, required
      - `ratio` string, required
      - `resolution` string, required
      - `quality` string, required
      - `asset_ids` string[], required
    - `status` 'queued' | 'submitting' | 'processing' | 'needs_review' | 'succeeded' | 'failed', required
    - `held_credits` integer, required
    - `consumed_credits` integer, nullable, required
    - `refunded_credits` integer, required
    - `asset_id` string, nullable, required
    - `output_url` string, nullable, required: Relative authenticated file URL; requires image:read. Null until persisted.
    - `error` string, nullable
    - `created` integer
    - `updated` integer

## 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)