GPT Image 2.6 Flare API 文档

ModelPort 图像接口

GPT Image 2.6 Flare

gpt-image-2.6-flare · OpenAI · 可调用状态以模型目录为准

图像生成模型。开通后会显示可用参数、价格和试用入口。

请求参数

参数可选值默认值
resolution1K / 2K / 4K1K
aspect_ratioauto / 1:1 / 3:2 / 2:3 / 4:3 / 3:4 / 5:4 / 4:5 / 16:9 / 9:16 / 2:1 / 1:2 / 3:1 / 1:3 / 21:9 / 9:21auto
qualitylow / medium / high / xhigh / max由渠道选择
output_formatgif / svg由渠道选择
size512x512 / 768x768由渠道选择
n11

prompt 最多 4000 个字符。

GIF 与 SVG

省略 output_format 生成静态图。GIF 支持文字或参考图,使用 1K 方形画面。帧尺寸为 512×512 或 768×768,最多分别为 16 帧和 12 帧。单帧时长可设为 20–2000 毫秒。

SVG 仅支持文字输入,使用 1K 或 2K,默认画面比例为 1:1。结果以 .svg 文件下载。

试算 GIF 报价

curl "https://api.apimodel.store/v1/quotes" \
  -H "Authorization: Bearer $MODELPORT_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model":"gpt-image-2.6-flare","prompt":"A pinwheel turns slowly.","parameters":{"output_format":"gif","size":"512x512","frame_count":6,"frame_duration_ms":160}}'

试算 SVG 报价

curl "https://api.apimodel.store/v1/quotes" \
  -H "Authorization: Bearer $MODELPORT_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model":"gpt-image-2.6-flare","prompt":"A two-color outline of a leaf.","parameters":{"output_format":"svg","resolution":"1K","aspect_ratio":"1:1"}}'

可选参数

参数取值使用条件
frame_count2–16同时提供 output_format
frame_duration_ms20–2000同时提供 output_format

参考素材

图像输入

每次 1–16 份素材。

请求角色数量时长限制
reference_image1–16—

上传后将返回的文件 ID 放入 references[].file_id,并用 references[].role 指定角色。

上传参考文件

调用示例

先设置 MODELPORT_API_KEY。cURL 示例使用 Bash 和 jq,Python 使用标准库,Node.js 示例保存为 .mjs 文件。示例会先获取报价,再提交生成任务。

cURL (Bash)

cURL (Bash)

set -eu
: "${MODELPORT_API_KEY:?Set MODELPORT_API_KEY}"
base='https://api.apimodel.store'
request='{"model":"gpt-image-2.6-flare","prompt":"A porcelain vase on a pale stone table, soft morning light.","parameters":{"resolution":"1K","aspect_ratio":"auto","n":1}}'
request_id=${MODELPORT_REQUEST_ID:-modelport-example-$(date +%s)-$$}

quote=$(curl --fail-with-body --max-time 45 -sS 'https://api.apimodel.store/v1/quotes' \
  -H "Authorization: Bearer $MODELPORT_API_KEY" \
  -H "Content-Type: application/json" --data "$request")
quoted_cap=$(printf '%s' "$quote" | jq -er '.billing_price_usd | strings')
cap=${MODELPORT_MAX_PRICE_USD:-$quoted_cap}
printf 'Request ID: %s, maximum charge: %s USD\n' "$request_id" "$cap" >&2
payload=$(printf '%s' "$request" | jq -ce --arg cap "$cap" '. + {max_price_usd: $cap}')

job=$(curl --fail-with-body --max-time 45 -sS "$base/v1/jobs" \
  -H "Authorization: Bearer $MODELPORT_API_KEY" -H "Idempotency-Key: $request_id" \
  -H "Content-Type: application/json" --data "$payload")
job_id=$(printf '%s' "$job" | jq -er '.id | strings')
printf 'Job ID: %s\n' "$job_id" >&2

attempt=0
while [ "$attempt" -lt 90 ]; do
  status=$(printf '%s' "$job" | jq -er '.status')
  case "$status" in succeeded|failed) break ;; esac
  sleep 2
  job=$(curl --fail-with-body --max-time 45 -sS "$base/v1/jobs/$job_id" -H "Authorization: Bearer $MODELPORT_API_KEY")
  attempt=$((attempt + 1))
done
printf '%s\n' "$job"
Python

Python

import json
import os
import time
import uuid
from urllib.request import Request, urlopen

BASE = "https://api.apimodel.store"
KEY = os.environ["MODELPORT_API_KEY"]
request_id = os.getenv("MODELPORT_REQUEST_ID") or str(uuid.uuid4())
payload = json.loads("{\"model\":\"gpt-image-2.6-flare\",\"prompt\":\"A porcelain vase on a pale stone table, soft morning light.\",\"parameters\":{\"resolution\":\"1K\",\"aspect_ratio\":\"auto\",\"n\":1}}")

def api(path, data=None, request_key=None):
    headers = {"Authorization": f"Bearer {KEY}"}
    if data is not None:
        headers["Content-Type"] = "application/json"
    if request_key:
        headers["Idempotency-Key"] = request_key
    body = json.dumps(data).encode("utf-8") if data is not None else None
    with urlopen(Request(BASE + path, data=body, headers=headers), timeout=45) as response:
        return json.load(response)

quote = api("/v1/quotes", payload)
cap = os.getenv("MODELPORT_MAX_PRICE_USD") or quote["billing_price_usd"]
print(f"Request ID: {request_id}, maximum charge: {cap} USD", flush=True)
job = api("/v1/jobs", {**payload, "max_price_usd": cap}, request_id)
job_id = job["id"]
print("Job ID:", job_id, flush=True)
for _ in range(90):
    if job["status"] in ("succeeded", "failed"):
        break
    time.sleep(2)
    job = api(f"/v1/jobs/{job_id}")
print(json.dumps(job, indent=2, ensure_ascii=False))
Node.js

Node.js

import { randomUUID } from "node:crypto";
import { setTimeout as sleep } from "node:timers/promises";

const base = "https://api.apimodel.store";
const key = process.env.MODELPORT_API_KEY;
if (!key) throw new Error("Set MODELPORT_API_KEY");
const requestId = process.env.MODELPORT_REQUEST_ID || randomUUID();
const payload = {
  "model": "gpt-image-2.6-flare",
  "prompt": "A porcelain vase on a pale stone table, soft morning light.",
  "parameters": {
    "resolution": "1K",
    "aspect_ratio": "auto",
    "n": 1
  }
};

async function api(path, data, requestKey) {
  const headers = { Authorization: `Bearer ${key}` };
  if (data) headers["Content-Type"] = "application/json";
  if (requestKey) headers["Idempotency-Key"] = requestKey;
  const response = await fetch(base + path, {
    method: data ? "POST" : "GET", headers,
    body: data && JSON.stringify(data), signal: AbortSignal.timeout(45_000),
  });
  if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
  return response.json();
}

const quote = await api("/v1/quotes", payload);
const cap = process.env.MODELPORT_MAX_PRICE_USD || quote.billing_price_usd;
console.log(`Request ID: ${requestId}, maximum charge: ${cap} USD`);
let job = await api("/v1/jobs", { ...payload, max_price_usd: cap }, requestId);
const jobId = job.id;
console.log("Job ID:", jobId);
for (let attempt = 0; attempt < 90 && !["succeeded", "failed"].includes(job.status); attempt++) {
  await sleep(2_000);
  job = await api(`/v1/jobs/${jobId}`);
}
console.log(JSON.stringify(job, null, 2));

重试同一次提交时,保持请求参数一致,并用首次输出的值设置 MODELPORT_REQUEST_ID 和 MODELPORT_MAX_PRICE_USD。

提交 POST /v1/jobs 时复用相同请求,按报价填写 max_price_usd 并附唯一 Idempotency-Key。用任务 ID 查询结果和费用。