今日花费
$1,248.00API Key
0 / 5我的 Key
全部 Key →我的 Key
全部 Key →模型目录
接入文档
快速完成 API 接入,全面兼容 OpenAI SDK 及标准格式
Base URL
https://yh.968968968.xyz/v1认证方式
Bearer Token兼容格式
OpenAI API 兼容格式价格说明
按模型倍率计费新手一键配置
选择 API Key、模型和系统,复制或下载 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 数据限制 |
响应结构示例
常见系统返回状态码
认证失败
API Key 无效、已禁用或提供错误
限额过快或余额不足
超过专线速率限制,或可用余额耗尽
服务临时异常
请求处理超时或服务临时不可用
Base URL
https://yh.968968968.xyz/v1图片接口
OpenAI Images API认证方式
Bearer Token价格说明
按图片分辨率计费图片定价 / 张
图片模型接入
使用 OpenAI 风格兼容格式调用文生图、图生图、多参考图编辑等能力。图片接口必须使用图片模型 Key,普通聊天 Key 不能调用。本接口兼容常见 OpenAI Images API 调用格式,但不是官方接口的完整复制,接入时请按下方参数说明调整。
| 序号 | 接口 | 方法 | 用途 |
|---|---|---|---|
| 1 | /images/generations | POST JSON | 文生图,根据提示词生成图片。 |
| 2 | /images/edits | POST JSON / multipart | 图生图、参考图编辑、遮罩编辑,支持 URL 或文件上传格式。 |
1. 文生图 JSON 示例
适合服务端直接调用,返回图片 URL。
2. 图生图 JSON URL 示例
已有平台支持的临时图片 URL 时,可以传入 image 字段。第三方图片地址建议改用 multipart 文件上传。
3. multipart 文件上传示例
兼容 OpenAI SDK 常见文件上传格式,适合本地图片编辑。
图片请求参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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 额度不足。
图片响应结构示例
图片接口常见状态码
认证失败
API Key 无效、已禁用或 Header 格式错误。
余额或频率限制
账户余额不足、额度不足或请求过快。
生成失败
图片生成超时、参数异常或服务临时不可用。