图片生成 API 接入教程：最低 0.03 元/张

1. 选择图片生成模型

本站已接入 GPT-image2、Gemini 与 Grok 图片生成能力。不同模型在画面风格、文字表现、编辑能力、尺寸支持和返回格式上可能不同。

先前往模型广场了解图片分类，再在API 密钥页面点击创建密钥，查看当前分组中的真实模型代号和倍率。

2. 准备 API Key 与请求地址

• 创建一个包含目标图片模型的 API Key。
• 复制密钥分组中显示的完整模型代号。
• 确认账户余额足够完成计划生成数量。
• OpenAI 兼容请求使用 https://www.codex789.com/v1。

3. 发送图片生成请求

以下是 OpenAI 兼容图片接口的通用示例。将 MODEL_ID 替换为创建密钥页面显示的真实代号；尺寸、数量和返回格式仅在目标模型支持时使用。

curl https://www.codex789.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "白色背景上的简洁科技产品主图，柔和棚拍光线，主体完整",
    "size": "1024x1024",
    "n": 1
  }'

如果控制台文档为某个模型提供了不同请求路径或专用参数，应以该模型的当前接口说明为准。

4. Python 请求示例

下面使用标准 HTTP 请求，便于查看完整响应。先安装依赖并通过环境变量设置 ISLAND_API_KEY。

pip install requests

import os
import requests

response = requests.post(
    "https://www.codex789.com/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['ISLAND_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "MODEL_ID",
        "prompt": "电影感城市夜景，清晰主体，蓝绿霓虹，横向构图",
        "size": "1024x1024",
        "n": 1,
    },
    timeout=180,
)

response.raise_for_status()
print(response.json())

图片生成通常比文字请求耗时更长。生产环境应设置合理读取超时，并避免在超时后立即无限重试。

5. 编写可控的图片提示词

相比堆叠形容词，结构化描述更容易复用。可以按以下顺序组织：

6. 三类常见应用场景

电商商品图

固定主体、背景、光线和画幅模板，每次只替换商品属性。批量任务应先抽样检查产品外观、文字和边缘细节。

短剧与漫剧素材

为角色建立稳定描述，统一服装、发型、色彩和镜头语言；按场次生成时保存每次使用的提示词与参数，方便返修。

办公封面与营销配图

预留标题区域并控制信息密度，先生成无文字底图，再在排版工具中添加准确标题和品牌信息。

7. 处理返回结果

根据模型与接口格式，结果可能返回图片地址或 Base64 数据。应用需要同时处理两种情况：

• 图片地址：在有效期内下载到自己的存储空间，不要长期依赖临时地址。
• Base64 数据：解码后检查文件类型、尺寸和大小，再写入存储。
• 批量任务：保存请求编号、模型代号、参数、扣费和输出位置。
• 用户输入：限制提示词长度，并过滤不应进入日志的敏感内容。

8. 常见错误排查