零度API 文档
POST

文生图

POST /v1/images/generations — 根据文本生成图片

文生图

根据文字描述(Prompt)生成图片,兼容 OpenAI API 格式。

POST https://api000.com/v1/images/generations

接口信息

HTTP 方法 POST
接口路径 /v1/images/generations
完整地址 https://api000.com/v1/images/generations
认证方式 Bearer Token

请求头

Header 参数 必填 示例
Content-Type application/json
Authorization Bearer sk-xxxxxxxxxxxxxxxx
Accept application/json

Authorization 必须填写,格式为:Bearer 空格 API Key。例如:Bearer sk-xxxxxxxxxxxxxxxx


请求参数

参数 类型 必填 说明
model string 必填 绘图模型 ID,如 gpt-image-2gpt-image-2-all
prompt string 必填 图片文字描述(Prompt),最长 4000 字符
n integer 可选 生成数量,默认 1,最多 10 张
size string 可选 图片尺寸,如 1024x1024
quality string 可选 "auto"(默认)、"low""medium""high"
style string 可选 "natural""vivid"(DALL-E 3)
response_format string 可选 "url"(默认)或 "b64_json"(Base64 数据)

请求示例

cURL

curl https://api000.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只在宇宙中漂浮的橙色猫咪,背景是紫色星云,写实摄影风格",
    "size": "1024x1024",
    "quality": "low",
    "n": 1
  }'

Python

from openai import OpenAI
import httpx

client = OpenAI(
    base_url="https://api000.com/v1",
    api_key="sk-xxxxxxxxxxxxxxxx"
)

response = client.images.generate(
    model="gpt-image-2",
    prompt="A cute orange cat floating in space with purple nebula background, photorealistic",
    size="1024x1024",
    quality="low",
    n=1
)

image_url = response.data[0].url
print(f"图片URL: {image_url}")

# 可选:下载图片到本地
img_data = httpx.get(image_url).content
with open("output.png", "wb") as f:
    f.write(img_data)
print("已保存为 output.png")

Node.js

import OpenAI from "openai";
import fs from "fs";
import https from "https";

const client = new OpenAI({
  baseURL: "https://api000.com/v1",
  apiKey: "sk-xxxxxxxxxxxxxxxx",
});

const response = await client.images.generate({
  model: "gpt-image-2",
  prompt: "A futuristic cityscape at night with neon lights, cyberpunk style",
  size: "1792x1024",
  quality: "low",
  n: 1,
});

console.log("图片URL:", response.data[0].url);

响应示例

{
  "created": 1677652288,
  "data": [
    {
      "url": "https://cdn.example.com/images/generated/xxx.png",
      "revised_prompt": "A cute orange cat with bright fur floating in deep space..."
    }
  ]
}

支持的尺寸

模型 支持尺寸
gpt-image-2 1024x1024(通用基础正方形)1536×1024(横向矩形)1024×1536(纵向矩形)1792×1024(宽屏横向)1024×1792(长竖版,短视频常用)2048×2048(2k正方形)2048×1152(2k横向画幅)3840×2160(4K横向16:9)2160×3840(4K纵向9:16)
gpt-image-2-all 1024x10241536x10241024x1536,以及符合要求的任意 宽x高(宽高均为 16 的倍数,比例 1:3~3:1,最大 3840x2160

Prompt 技巧

  • 指定风格:photorealistic(写实)、oil painting(油画)、anime style(动漫风)
  • 指定构图:wide shot(全景)、close-up(特写)、bird's eye view(俯视)
  • 指定光照:golden hour(黄金时段)、dramatic lighting(戏剧性光线)
  • 指定细节:8K resolution、highly detailed、sharp focus
零度API 文档