跳转到主要内容
POST

授权

string
默认值:"Bearer ${YOUR_API_KEY}"
必填
使用 Bearer 方式发送的 Neural4D API 密钥。

请求体 application/json

省略可选参数时使用所选模型的当前默认值。超出该模型支持范围的分辨率或宽高比会返回 unsupported_resolution 或 unsupported_aspect_ratio。 每张参考图片最多 10 MiB,通过 file_id 或 url 传入时使用相同限制。
enum<string>
必填
GPT Image 2 模型标识。可选值:openai/gpt-image-2。
string
必填
描述待生成或编辑图片的文本提示词。字符串长度:1 - 500。
object[]
可选参考图片。可将 POST /openapi/v1/files 返回的 id 填入 file_id,或通过 url 直接传入图片的公网 HTTPS 地址。仅支持 JPG、JPEG、PNG 和 WEBP 图片,每张最多 10 MiB。图片须通过内容审核。数组总长度:0 - 6 个元素。可混用文件 ID 和 URL,素材顺序保持不变。每个元素必须且只能提供 file_id、url 中的一个。
integer
默认值:1
要创建的图片生成任务数量。取值范围:1 <= x <= 4。
enum<string>
默认值:"2K"
命名输出分辨率。可选值:1K、2K、4K。
enum<string>
默认值:"1:1"
目标图片宽高比。可选值:1:1、16:9、9:16、4:3、3:4。

响应

请通过 error.code 区分错误原因,不要依赖错误消息文本。
已接受生成任务
string
必填
生成请求返回的批次任务 ID。示例:"normal-image-c50fe63e-699d-4d61-93f5-2099ab159d6d"。
object[]
必填
本次请求创建的生成结果子项。数组长度:至少 1 个元素。
enum<string>
必填
本次提交的图片任务的当前状态。可选值:queued、processing、succeeded、failed。
integer<int64>
必填
批次任务创建时间的 Unix 时间戳,单位为秒。
enum<string>
必填
本次提交任务使用的图片生成模式。可选值:text_to_image、image_to_image。
enum<string>
必填
本次提交任务使用的图片生成模型。可选值:openai/gpt-image-2、google/nano-banana-pro、bytedance/seedream-4.5、black-forest-labs/flux-2-pro、google/nano-banana-2-lite。
object
可用时返回本次提交任务扣除的总点数。