图片生成与编辑

Orbit AI API 团队2026/07/11约 6 分钟阅读

Orbit AI API 提供 OpenAI 兼容的图片接口，可用于图片生成和图片编辑。将 Base URL 指向 Orbit AI API，再配置控制台中的 API Key 即可调用。

连接参数

参数	值
Base URL	https://orbitaiapi.site/v1
认证方式	Authorization: Bearer YOUR_API_KEY
模型名称	以控制台模型列表中显示的名称为准，例如 gpt-image-2、gpt-image-2-all 或 Gemini 图片模型

图片生成

接口：POST /v1/images/generations

cURL 示例

curl -X POST "https://orbitaiapi.site/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张高级感产品海报，干净背景，真实摄影风格",
    "size": "1024x1024",
    "quality": "auto",
    "n": 1,
    "response_format": "url"
  }'

请求字段

字段	是否必填	说明
model	必填	图片模型名，例如 gpt-image-2、gpt-image-2-all 或 Gemini 图片模型。
prompt	必填	图片描述。
size	可选	GPT 图片常用 1024x1024、1536x1024、1024x1536。Gemini 图片可用比例或模型支持的尺寸。
quality	可选	常见值：auto、low、high、2K、4K。不同模型支持不同。
n	可选	生成数量，通常填 1。
response_format	可选	url 或 b64_json。一般建议 url。

Gemini 图片常用写法

Gemini 图片模型可在 size / quality 中直接传比例与分辨率，也可通过 extra_fields 补充 Google 原生参数：

curl -X POST "https://orbitaiapi.site/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image",
    "prompt": "生成一张 9:16 的赛博风人物海报",
    "size": "9:16",
    "quality": "2K",
    "extra_fields": {
      "google": {
        "image_config": {
          "aspect_ratio": "9:16",
          "image_size": "2K"
        }
      },
      "aspect_ratio": "9:16",
      "image_size": "2K"
    },
    "response_format": "url"
  }'

JavaScript 示例

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.ORBIT_API_KEY,
  baseURL: 'https://orbitaiapi.site/v1',
});

const result = await client.images.generate({
  model: 'gpt-image-2',
  prompt: '一张高级感产品海报，干净背景，真实摄影风格',
  size: '1024x1024',
  quality: 'auto',
  n: 1,
  response_format: 'url',
});

console.log(result.data[0].url);

图片编辑

接口：POST /v1/images/edits

用于在已有图片基础上按提示词修改。该接口通常使用 multipart/form-data 上传原图。

cURL 示例

curl -X POST "https://orbitaiapi.site/v1/images/edits" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image=@./input.png" \
  -F "prompt=把背景改成浅灰色，保留主体产品，真实摄影风格" \
  -F "size=1024x1024" \
  -F "n=1" \
  -F "response_format=url"

请求字段

字段	是否必填	说明
model	必填	支持图片编辑的模型名称，以控制台为准。
image	必填	原始图片文件。常见格式：PNG、JPG、WEBP。
prompt	必填	编辑说明，描述希望如何修改图片。
mask	可选	遮罩图。白色区域表示可编辑，黑色区域表示保留。部分模型支持。
size	可选	输出尺寸，例如 1024x1024。以模型支持为准。
n	可选	生成数量，通常填 1。
response_format	可选	url 或 b64_json。一般建议 url。
quality	可选	输出质量，常见值：auto、low、high。不同模型支持不同。

JavaScript 示例

import fs from 'fs';
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.ORBIT_API_KEY,
  baseURL: 'https://orbitaiapi.site/v1',
});

const result = await client.images.edit({
  model: 'gpt-image-2',
  image: fs.createReadStream('./input.png'),
  prompt: '把背景改成浅灰色，保留主体产品，真实摄影风格',
  size: '1024x1024',
  n: 1,
  response_format: 'url',
});

console.log(result.data[0].url);

响应示例

成功时，常见返回结构如下：

{
  "created": 1710000000,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

若使用 response_format: "b64_json"，则返回字段为 b64_json 而不是 url。

使用建议

• 模型名请从 模型列表 或控制台复制，不要硬编码可能下线的名称。
• 生成类请求优先使用清晰、具体的 prompt；编辑类请求应明确“保留什么、修改什么”。
• 一般建议 response_format 使用 url，便于直接预览和下载。
• 生产环境请通过后端调用，不要在前端暴露 API Key。
• 不同图片模型支持的尺寸、质量和编辑能力可能不同，请以控制台与实际返回结果为准。

常见问题

• 401：检查 Authorization: Bearer YOUR_API_KEY 是否正确，以及 Key 是否启用。
• 404：确认 Base URL 包含 /v1，且路径为 /images/generations 或 /images/edits。
• 模型不可用：确认账户有额度，并使用控制台中显示的准确模型名。
• 编辑失败：检查原图格式、文件大小是否符合模型要求，以及 prompt 是否足够明确。

更多通用接入说明见 OpenAI 兼容接入。