Optimize a media prompt

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

POST/v1/media/prompt-optimizations

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

Must exactly equal clientRequestId. Replay the same body with the same key after an uncertain network result.

Length8 <= length <= 128

Request Body

application/json

audioReferencePolicy?"preserve_without_understanding"

Required when H3 audio references are present. Only image/video are understood; audio is retained by explicit text intent, never analyzed.

Value in

"preserve_without_understanding"

clientRequestId*string

Match^[A-Za-z0-9._:-]+$

Length8 <= length <= 128

generationMode*string

Allowed modes are published by the selected service promptOptimization.profiles.

mediaSpec*

Only these six selectable dimensions are decoded; required values depend on the selected generation mode.

model*string

Public model alias from GET /v1/services.

originalPrompt*string

H3 typed-media/v1 supports 7000 Unicode code points; other profiles retain their advertised lower limit.

Length1 <= length <= 7000

referenceInputs*array<>

Use uploaded owner asset IDs. H3 typed roles: first_frame/last_frame, or reference_image (0..9), reference_video (0..1), reference_audio (0..3), at least one visual, at most 12 total. Same-kind array order determines numbering; other profiles retain their advertised roles.

Itemsitems <= 12

style?string

Optional H3 typed-media/v1 creative style preference.

Length1 <= length <= 200

Response Body

`application/json`

{  "optimization": {    "createdAt": "2019-08-24T14:15:22Z",    "expiresAt": "2019-08-24T14:15:22Z",    "generationMode": "string",    "noticeCodes": [      "string"    ],    "optimizationId": "string",    "optimizedPrompt": "string",    "originalPrompt": "string",    "outcome": "string",    "serviceKind": "string",    "status": "succeeded"  },  "requestId": "string"}

Optimize a media prompt

Authorization

Header Parameters

Request Body

Response Body

201application/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`