ORANGE API DOCUMENTATION

橙子API 使用与接入文档

一份文档完成 AI 对话、视频与图片接入 · API 地址：https://plus789.cc

免安装 · 在线测试 ↗

OpenAI 兼容支持自定义 Base URL 的客户端

11 个当前模型7 个文本 · 2 个视频 · 2 个图片

橙子 AI v592026-08-11 与当前网页同步

一、3步开始使用

注册并登录
打开 https://plus789.cc 注册账号并登录，完成充值（钱包管理）。

创建你的密钥
控制台 → 令牌管理 → 添加令牌，得到一串以 sk- 开头的密钥。这是你的"通行证"，请妥善保管、不要发给别人。

选择使用方式
不写代码 → 点上方"在线测试直达"用网页工具；写代码/接软件 → 看对话 / 视频 / 图片 API 章节。

二、网页版「橙子AI」使用指南

网页版已经集成文本对话、视频和图片生成。打开 chat.plus789.cc →，按下面顺序使用：

配置密钥
左下角 ⚙ 设置 → 填写默认密钥并测试。需要分渠道时，可为任意模型填写专用密钥；专用密钥优先，留空则使用默认密钥。

选择模型类型
在输入框上方切换「文本 / 视频 / 图片」，再选择具体模型。页面会自动显示该模型可用的时长、比例、清晰度或图片尺寸。

添加图片并发送
单张图片最大 12MB。文本模型可用于识图提问；图片模型可加入参考图；视频模型的数量限制见第五章。

连续生成
同一对话允许连续提交多个任务，彼此独立显示进度。视频超过 5 分钟仍会继续轮询，不会被网页误判为失败。

生成结果可能使用临时链接。看到结果后请及时下载，避免链接过期后无法再次打开。

作品库与下载

页面右上角的「作品库」会自动汇总当前浏览器中各个对话生成成功的图片和视频：

按全部、图片、视频筛选作品，并显示各分类数量。
支持多选、全选当前分类、批量下载和删除所选作品。
删除作品会同步移除对应对话中的生成结果；删除后无法在页面内恢复。
对话、密钥和作品索引保存在当前浏览器；清理浏览器数据或更换设备后不会自动同步。

三、当前模型（共 11 个）

💬 文本对话7 个模型

gpt-5.6-luna极速

日常问答、翻译、总结与批量文案。

gpt-5.6-terra均衡

长文写作、方案整理和多数工作任务。

gpt-5.6-sol高阶

复杂分析、严谨推理与高要求代码任务。

gpt-5.5经典

通用文本模型，适合较复杂的对话与创作。

gpt-5.4-mini经典

轻量文本模型，适合简单快速的日常任务。

claude-fable-5创作

创意写作、内容润色和日常文本任务。

claude-opus-4-8旗舰

复杂分析、长文写作和高要求推理任务。

🖼 图片生成2 个模型

gpt-image-2按次

支持 1K / 2K、多参考图，约 60–120 秒。

gpt-image-2-4K按次

支持 2K / 4K 与多种常用画面比例。

🎬 视频生成2 个模型

grok-image-video多参考图

文生、单图支持 1–15 秒；2–7 张多参考图支持 1–10 秒。

grok-video-1.5旗舰

仅支持单图生视频，支持 1–15 秒与 480p / 720p。

版本与计费说明

当前版本：橙子 AI v59。新请求请只使用上面列出的 11 个模型名。旧名称 grok-4.5、grok-video-1.5fast、grok-video-1.5-1080p 已不再显示为独立模型。

模型价格可能随渠道调整。本文不写死单价，请登录 plus789.cc，以「模型广场」的实时价格和计费单位为准。

四、文本对话 API

文本模型使用 OpenAI 兼容的聊天补全接口。客户端要求填写 Base URL 时，通常填写 https://plus789.cc/v1；若客户端会自动追加 /v1，则填写 https://plus789.cc。

可用文本模型：gpt-5.6-luna、gpt-5.6-terra、gpt-5.6-sol、gpt-5.4-mini、gpt-5.5、claude-fable-5、claude-opus-4-8。

POST https://plus789.cc/v1/chat/completions
Authorization: Bearer sk-你的密钥
Content-Type: application/json

{
  "model": "gpt-5.6-terra",
  "messages": [
    { "role": "user", "content": "帮我写一段周报开头" }
  ],
  "stream": false
}

橙子 AI 网页使用 stream: true 流式接收文本，并只携带当前对话最近 20 条消息以控制上下文开销。自行接入时可按需要选择流式或非流式。

Python（openai 库）：

from openai import OpenAI
client = OpenAI(api_key="sk-你的密钥", base_url="https://plus789.cc/v1")
r = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[{"role": "user", "content": "你好"}])
print(r.choices[0].message.content)

五、视频 API

当前视频模型通过同一套异步接口接入：创建任务 → 按任务 ID 轮询 → 读取视频地址。

5.1 当前模型规则

模型	参考图	seconds	aspect_ratio	resolution
`grok-image-video`	0 张：文生视频 1 张：单图生视频 2–7 张：多参考图	文生 / 单图：`"1"`–`"15"` 多参考图：`"1"`–`"10"`	16:9 / 9:16 / 1:1	480p / 720p
`grok-video-1.5`	必须且只能 1 张	`"1"`–`"15"`	16:9 / 9:16	480p / 720p

多参考图规则：grok-image-video 上传 2–7 张参考图时最长 10 秒。橙子 AI 网页会把超过 10 秒的值自动调整为 10 秒；直接调用 API 时也应主动限制为 10 秒以内。

seconds 请传字符串形式的整数，例如 "1"、"8"、"15"，不要传数字。

5.2 创建视频任务

POST https://plus789.cc/v1/video/generations
Authorization: Bearer sk-你的密钥
Content-Type: application/json

{
  "model": "grok-image-video",
  "prompt": "雨夜霓虹街道，一辆红色跑车驶过，电影质感",
  "seconds": "8",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "image_urls": ["https://example.com/reference.jpg"]
}

image_urls 可放公网图片 URL 或 data:image/...;base64,...。文生视频时省略该字段；grok-video-1.5 必须提供且只能提供 1 张。

创建成功后读取 task_id（部分兼容响应也可能使用 id）：

{ "task_id": "task_xxxxxxxx", "status": "queued" }

5.3 查询任务结果

GET https://plus789.cc/v1/video/generations/{task_id}
Authorization: Bearer sk-你的密钥

建议开始时每 5 秒查询一次；等待超过 5 分钟后可改为每 10 秒一次。响应可能直接返回任务对象，也可能包在 data 内。

状态	含义	处理方式
`QUEUED` / `SUBMITTED` / `IN_PROGRESS`	排队或生成中	继续轮询
SUCCESS / `SUCCEEDED` / `COMPLETED` / `DONE`	成功	读取结果地址并尽快下载
FAILURE / `FAILED` / `ERROR` / `CANCELLED`	失败或取消	读取 `fail_reason` 并记录任务 ID

视频地址依次兼容 result_url、video_url、url，或 output 数组中的第一个有效 URL。

请以状态和结果地址判断是否完成。不要只看 progress 是否为 100%。

5.4 Python 完整示例

展开创建、轮询与取地址代码

import time
import requests

BASE = "https://plus789.cc"
HEADERS = {"Authorization": "Bearer sk-你的密钥"}

body = {
    "model": "grok-image-video",
    "prompt": "太空中漂浮的橘猫，电影质感",
    "seconds": "8",
    "aspect_ratio": "16:9",
    "resolution": "720p"
}

created = requests.post(
    f"{BASE}/v1/video/generations",
    headers=HEADERS, json=body, timeout=60
).json()
task_id = created.get("task_id") or created["id"]

while True:
    time.sleep(5)
    response = requests.get(
        f"{BASE}/v1/video/generations/{task_id}",
        headers=HEADERS, timeout=60
    ).json()
    data = response.get("data", response)
    status = str(data.get("status", "")).upper()
    url = (data.get("result_url") or data.get("video_url") or data.get("url"))
    if not url and isinstance(data.get("output"), list):
        url = next((x for x in data["output"] if isinstance(x, str)), None)
    if url:
        print("视频地址：", url)
        break
    if status in {"FAILURE", "FAILED", "ERROR", "CANCELLED", "CANCELED"}:
        raise RuntimeError(data.get("fail_reason", "视频任务失败"))

六、图片 API（gpt-image-2 / gpt-image-2-4K）

图片使用同步接口：请求会一直等待生成结果，不需要任务轮询。建议客户端超时设置为 300 秒以上；反向代理可按部署说明设置为 600 秒。

POST https://plus789.cc/v1/images/generations
Authorization: Bearer sk-你的密钥
Content-Type: application/json

{
  "model": "gpt-image-2",
  "prompt": "赛博朋克风格的橙子，霓虹光效",
  "size": "1024x1024",           ← 可选值见下表
  "n": 1,
  "image": ["data:image/...;base64,xxx"]   ← 可选，参考图
}

image 为可选参考图数组，可传公网 URL 或 data URL。橙子 AI 网页最多添加 7 张，每张不超过 12MB。

常见响应位于 data[0].url 或 data[0].b64_json。接入时建议同时兼容直链、data URL 和纯 base64 三类结果。

尺寸传法：size 必须填写实际像素值，例如 16:9（2K）传 "2560x1440"，不能直接传 "16:9"。下面列出的 28 种尺寸与当前橙子 AI 配置一致。

gpt-image-2 · 1K / 2K（16 种尺寸）

档位	比例	size 请求值
1K	1:1	`1024x1024`
1K	4:3	`1024x768`
1K	3:4	`768x1024`
1K	3:2	`1008x672`
1K	2:3	`672x1008`
1K	16:9	`1280x720`
1K	9:16	`720x1280`
1K	21:9	`1344x576`
2K	1:1	`2048x2048`
2K	4:3	`2304x1728`
2K	3:4	`1728x2304`
2K	3:2	`2496x1664`
2K	2:3	`1664x2496`
2K	16:9	`2560x1440`
2K	9:16	`1440x2560`
2K	21:9	`3024x1296`

gpt-image-2-4K · 2K / 4K（12 种尺寸）

档位	比例	size 请求值
2K	1:1	`2048x2048`
2K	4:3	`2048x1536`
2K	3:2	`2560x1712`
2K	2:3	`1712x2560`
2K	16:9	`2048x1152`
2K	9:16	`1152x2048`
4K	1:1	`2880x2880`
4K	4:3	`3840x2880`
4K	3:2	`3840x2560`
4K	2:3	`2560x3840`
4K	16:9	`3840x2160`
4K	9:16	`2160x3840`

七、常见问题 FAQ

旧 Grok 模型名称还能继续使用吗？

当前新任务只应使用 grok-image-video 和 grok-video-1.5。橙子 AI 会把旧对话中的 grok-video-1.5fast、grok-video-1.5-1080p 迁移为 grok-video-1.5；grok-4.5 已不在当前模型列表中。

为什么多参考图最多只能生成 10 秒？

grok-image-video 使用 0 张或 1 张图片时支持 1–15 秒；使用 2–7 张图片时属于多参考图生视频，只支持 1–10 秒。网页选择超过 10 秒时会自动调整为 10 秒。

grok-video-1.5 为什么必须上传图片？

该模型当前仅支持单图生视频，必须且只能上传 1 张参考图。文生视频或多参考图生成请改用 grok-image-video。

视频接口为什么提示 seconds 类型错误？

seconds 必须使用字符串形式的整数，例如 "8"，不能传数字 8。允许范围还要符合对应模型及参考图数量限制。

newapi / sub2api 面板的“测试”按钮为什么报错？

许多面板的通用测试只调用聊天补全接口，因此不能验证图片和视频模型。请发送第五、六章中的真实请求，或直接在橙子 AI 网页中测试对应模型。

作品库里有记录，但结果链接打不开？

作品记录保存在当前浏览器，但上游图片或视频地址可能是临时链接。生成完成后应及时下载；链接过期后，作品库仍可能保留记录，但无法恢复已经失效的远程文件。

图片为什么有时返回 URL，有时返回 base64？

两种都是正常结果。URL 可以直接下载；b64_json 等 base64 字段需要加上 data:image/png;base64, 后显示或解码保存。建议客户端同时兼容两类返回。

任务失败时怎样快速排查？

请记录任务 ID、模型名、提交时间、参考图数量、seconds、aspect_ratio、resolution、最终 status 和 fail_reason。联系站长时一并提供这些信息。