Create media

接口参考来自当前平台公开协议。具体模型的模式和规格请在模型详情中确认。

POST/v1/media/generations

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Header Parameters

X-Client-Request-Id?string

Optional visible ASCII client correlation value, at most 512 bytes. It never replaces the server requestId.

Lengthlength <= 512

Idempotency-Key?string

Strongly recommended stable business key. Required for safe replay after an unknown result. Reusing a key with a different canonical request conflicts.

Public video creation uses top-level fields, not the deployed application's params/mediaSpec envelope. H3 requires generationMode/resolutionTier/orientation/seconds, only 768p, 5..15 seconds, max 7000 characters. t2v has no inputs; i2v requires first image; first_last_frame_video requires first+last; universal requires typed references. Per-model required/conditional fields remain in mediaSpecContract. Do not send H3 fps, frames, width/height, steps or runtime settings.

end_image_asset_id?string

Previously uploaded last-frame image. H3 first_last_frame_video only.

generationMode?string

Required for H3: t2v, i2v, first_last_frame_video, universal_reference_video. Other models publish their allowed modes.

input_audio_asset_id?string

Input audio for models whose service contract declares it; not an H3 universal reference field.

input_image_asset_id?string

Previously uploaded first-frame image. H3 i2v and first_last_frame_video only.

input_video_asset_id?string

Input video for models whose service contract declares it; not an H3 universal reference field.

model*string

Public model alias from GET /v1/services; never a workload or deployment name.

orientation?string

Value in

"landscape"
"portrait"

prompt*string

Generation instructions. H3 accepts 1..7000 Unicode code points after trimming.

referenceInputs?array<>

H3 universal references: up to 9 images without video, 8 with one video; up to 3 audios, total <=12, at least one visual. Order within each kind fixes numbering. IDs must be unique and owned by this caller/model.

Itemsitems <= 12

resolutionTier?string

H3: 768p. Other services publish their own tiers.

seconds?integer

Requested generation seconds. H3: integer 5..15; actual media duration and frame count are separate facts.

seed?integer

Optional reproducibility input; do not change it during an idempotent retry.

Range0 <= value <= 2147483647

[key: string]?any

Response Body

`application/json`

{  "id": "job_example",  "jobId": "job_example",  "jobUrl": "https://api.example.test/v1/jobs/job_example?model=minimax-h3",  "model": "minimax-h3",  "requestId": "req_example",  "serviceKind": "video_generation",  "stage": "queued",  "status": "queued"}

Authorization

Header Parameters

Request Body

Response Body

200application/json

202application/json

400application/json

401application/json

402application/json

403application/json

404application/json

409application/json

413application/json

415application/json

422application/json

429application/json

500application/json

502application/json

503application/json

504application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`