B
账户钱包
$12,560.00

今日花费

$1,248.00

API Key

0 / 5
API Base URL /v1
10,320.50 0% $0.00 $0.00

我的 Key

全部 Key →

我的 Key

全部 Key →

模型目录

点击模型卡片复制模型名
当前查看:-

接入文档

快速完成 API 接入,全面兼容 OpenAI SDK 及标准格式

Base URL

https://yh.968968968.xyz/v1

认证方式

Bearer Token

兼容格式

OpenAI API 兼容格式

价格说明

按模型倍率计费

新手一键配置

选择 API Key、模型和系统,复制或下载 Codex 配置脚本运行。

推荐新手
安装 Codex

脚本会自动备份并修改 Codex 配置;如果未安装 Codex,请先点击“安装 Codex”。

API 在线调试沙盒

选择 API Key 与模型,输入用户消息后实时查看模型响应。

实时流式
请求配置
用户消息

写下要发送给模型的消息。

模型消息

模型返回内容会显示在这里。

等待发送测试请求...

高级接入示例

给开发者使用的 cURL / SDK 调用示例。

请求参数说明

参数名 类型 必填 说明
model string 例如 gpt-4o 或 claude-3-5-sonnet
messages array 标准对话消息结构列表 [role, content]
temperature number 采样温度参数 (0.0 至 2.0 范围)
stream boolean 是否开启动态 SSE 流式数据返回形式
max_tokens integer 本次生成的最大响应 Token 数据限制

响应结构示例

{ "id": "chatcmpl-8xJY2hYz1h1", "object": "chat.completion", "created": 1715678900, "model": "gpt-4o-mini", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "我是 968 API,一个高效的 AI 模型专线。" }, "finish_reason": "stop" } ] }

常见系统返回状态码

401

认证失败

API Key 无效、已禁用或提供错误

429

限额过快或余额不足

超过专线速率限制,或可用余额耗尽

500

服务临时异常

请求处理超时或服务临时不可用

Base URL

https://yh.968968968.xyz/v1

图片接口

OpenAI Images API

认证方式

Bearer Token

价格说明

按图片分辨率计费

图片定价 / 张

1K0.04 2K0.06 4K0.10

图片模型接入

使用 OpenAI 风格兼容格式调用文生图、图生图、多参考图编辑等能力。图片接口必须使用图片模型 Key,普通聊天 Key 不能调用。本接口兼容常见 OpenAI Images API 调用格式,但不是官方接口的完整复制,接入时请按下方参数说明调整。

Images API
序号 接口 方法 用途
1 /images/generations POST JSON 文生图,根据提示词生成图片。
2 /images/edits POST JSON / multipart 图生图、参考图编辑、遮罩编辑,支持 URL 或文件上传格式。

1. 文生图 JSON 示例

适合服务端直接调用,返回图片 URL。

curl https://yh.968968968.xyz/v1/images/generations \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "A premium black diamond product render on a clean white background", "size": "1024x1024", "n": 1, "response_format": "url" }'

2. 图生图 JSON URL 示例

已有平台支持的临时图片 URL 时,可以传入 image 字段。第三方图片地址建议改用 multipart 文件上传。

curl https://yh.968968968.xyz/v1/images/edits \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "Make the product more glossy and premium", "image": "https://img.968968968.xyz/i/reference.png", "size": "1024x1024", "n": 1, "response_format": "url" }'

3. multipart 文件上传示例

兼容 OpenAI SDK 常见文件上传格式,适合本地图片编辑。

curl https://yh.968968968.xyz/v1/images/edits \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "model=gpt-image-2" \ -F "prompt=Turn this into a premium product poster" \ -F "size=1024x1024" \ -F "n=1" \ -F "response_format=url" \ -F "image=@reference.png;type=image/png"

图片请求参数说明

参数名 类型 必填 说明
model string 图片模型名称,例如 gpt-image-2。
prompt string 图片生成或编辑提示词。
image string / file 编辑时必填 参考图。multipart 文件上传最稳;JSON URL 方式仅支持平台临时上传地址或已允许的图片地址,多图可使用 image[]。
mask string / file 遮罩图,用于局部编辑。
size string 输出尺寸,例如 1024x1024、1024x1536、1536x1024;未传时默认 1024x1024。不要传 auto、1792x1024、1024x1792 等未列出的官方尺寸。
n integer 生成数量,默认 1。
route_id integer 图片通道 ID;普通客户不要传。不传时系统会按当前分辨率自动选择可用通道。只有后台明确提供通道 ID 时才传,传入后只使用指定通道,失败不会自动切换其他通道。
response_format string 推荐使用 url,返回可访问的图片链接。接入工具请读取 data[0].url,不要按部分官方示例读取 data[0].b64_json。
quality / background / output_format string 兼容官方常见字段;未使用时可不传。

当前支持尺寸:1K 档支持 1024x1024、1536x864、864x1536、1280x960、960x1280、1536x1024、1024x1536、1536x656、656x1536、1536x512、512x1536;2K 档支持 2048x2048、2560x1440、1440x2560、2304x1728、1728x2304、2496x1664、1664x2496、3024x1296、1296x3024、3072x1024、1024x3072;4K 档支持 2880x2880、3840x2160、2160x3840、3328x2496、2496x3328、3520x2352、2352x3520、3840x1648、1648x3840、3840x1280、1280x3840。

官方工具接入提示:base URL 请填写 https://yh.968968968.xyz/v1,Key 使用图片模型 Key;文生图返回图片请读取 data[0].url;不要传 route_id;尺寸请使用本文档列出的尺寸。

常见报错:image_key_required 表示用了普通 Key,需要换成图片模型 Key;invalid_size 表示尺寸不支持,请改成文档列出的尺寸;invalid_image_url 表示图生图 URL 不支持,建议改用 multipart 文件上传;invalid_image_route 通常是传了错误或不可用的 route_id,删除 route_id 让系统自动选择即可;insufficient_balance 表示图片 Key 额度不足。

图片响应结构示例

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

图片接口常见状态码

401

认证失败

API Key 无效、已禁用或 Header 格式错误。

429

余额或频率限制

账户余额不足、额度不足或请求过快。

500

生成失败

图片生成超时、参数异常或服务临时不可用。