- Client
- Video
- Chat
- Projects
- List Projects
- Create Project
- List Public Projects
- Get Project
- Update Project
- Delete Project
- Fork Project
- List Characters
- Create Character
- Update Character
- Delete Character
- List Appearances
- Create Appearance
- List Project Appearances
- Update Appearance
- Delete Appearance
- List Scenes
- Create Scene
- Update Scene
- Delete Scene
- List References
- Create Reference
- Update Reference
- Delete Reference
- List Episodes
- Create Episode
- Get Episode
- Update Episode
- Delete Episode
- List Episode Resources
- Add Episode Resource
- Remove Episode Resource
- List Episode Segments
- Create Episode Segment
- Update Episode Segment
- Delete Episode Segment
- Reorder Episode Segments
- Create Segment Version
- List Segment Versions
- Update Segment Version
- Delete Segment Version
- Download Episode Videos
- 数据模型
- Body_upload_video_asset_v1_video_assets_upload_post
- AdminOverviewFailedTask
- AddEpisodeResourceRequest
- ClientCreate
- AdminOverviewResponse
- ClientResponse
- AdminUsageLogResponse
- HTTPValidationError
- ClientBillingEntry
- KeyCreate
- KeyGrant
- KeyListResponse
- KeyResponse
- ProxyRouteCreate
- CreateAppearanceRequest
- ProxyRouteResponse
- CreateCharacterRequest
- ProxyRouteTargetCreate
- CreateEpisodeRequest
- ProxyRouteTargetResponse
- CreateEpisodeSegmentRequest
- ProxyRouteTargetUpdate
- PayPalCreateOrderRequest
- CreateProjectRequest
- ProxyRouteUpdate
- CreateReferenceRequest
- TopviewOmniReferenceSubmitRequest
- CreateSceneRequest
- TopviewReferenceAsset
- CreateVersionRequest
- UpstreamKeyCreate
- ForgotPasswordRequest
- UpstreamKeyListResponse
- SessionProfile
- GoogleCallbackRequest
- UpstreamKeyResponse
- GoogleMergeRequest
- UpstreamProviderCreate
- UpstreamProviderResponse
- ImageGenerationSubmitRequest
- UpstreamProviderUpdate
- UpstreamKeyUpdate
- ValidationError
- VideoOmniReferenceSubmitRequest
- VideoReferenceInput
- UpstreamUsageLogResponse
- UpstreamProviderModelConfig
- LocalAuthRequest
- LocalSignupResponse
- ReorderEpisodeSegmentsRequest
- ResetPasswordRequest
- RoutingRuleCreate
- RoutingRuleResponse
- RoutingRuleUpdate
- StripeCheckoutRequest
- SubscriptionCheckoutRequest
- UpdateAppearanceRequest
- UpdateCharacterRequest
- UpdateEpisodeRequest
- UpdateEpisodeSegmentRequest
- UpdateProjectRequest
- UpdateReferenceRequest
- UpdateSceneRequest
- UpdateVersionRequest
提交图片生成任务
POST
/v1/image/task/submit
fileId，平台在内部选择合适的上游、处理鉴权和计费。1:1、16:9、9:16 等；不同上游支持的比例集合不同，不支持时返回 400。1k / 2k / 4k；部分档位与比例组合可能被上游限制。taskId + status=queued|submitted，需后续轮询 /v1/image/task/query；同步模型直接返回 status=completed 和图片 URL。请使用 Idempotency-Key 头幂等提交（最长 255 字符）。请求参数
Authorization
API Key
在 header 添加参数
X-API-Key
示例：
X-API-Key: ********************or
Body 参数application/json必填
示例
{
"model": "string",
"prompt": "string",
"references": [
{
"fileId": "string",
"name": "string"
}
],
"aspectRatio": "string",
"size": "string",
"outputFormat": "string",
"watermark": false,
"generatingCount": 1,
"internetSearch": false
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://superouter.nesports.top/v1/image/task/submit' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"model": "string",
"prompt": "string",
"references": [
{
"fileId": "string",
"name": "string"
}
],
"aspectRatio": "string",
"size": "string",
"outputFormat": "string",
"watermark": false,
"generatingCount": 1,
"internetSearch": false
}'返回响应
🟢200
application/json
Bodyapplication/json
示例
{
"code": "200",
"message": "Success",
"result": {
"taskId": "task_ce7a42ce8f804219b315f1c852f71c34",
"status": "queued",
"queue_info": {
"queue_idx": 0,
"queue_length": 1,
"forecast_queue_cost": 0,
"forecast_generate_cost": 60
}
}
}🟠400
🟠402
🟠422
🟠429
修改于 2026-04-24 06:44:39