POST
/v1/images/generations同步接口在同一请求内返回 data[0].url，无需轮询。请设置 900 秒超时，并为每个业务订单使用唯一的 Idempotency-Key。
IMAGE WORKBENCH
图片创作台
上传参考图或直接描述画面，生成完成后自动保存结果并结算积分。
可用积分
0.0000 积分
POINTS WALLET
积分充值
在线支付成功后由服务器验签，按 1 元 = 1 积分自动到账。
当前积分0.0000 积分
充值记录
未支付订单不会扣款或增加积分。
| 订单 / 时间 | 方式 | 支付金额（人民币） | 状态 |
|---|
CALL HISTORY
我的历史记录
网页创作和 API 调用都会保留在这里；只能查看当前账号自己的记录。
| 任务 / 时间 | 缩略图 | 来源 | 模型 / 模式 | 状态 | Token | 预占积分 | 消耗积分 |
|---|
DEVELOPER API
API 调用文档
完整文档直接显示在当前账户中，也可以复制或下载 Markdown。
我的密钥
可随时停用泄露或不再使用的密钥。
| 名称 | 前缀 | 状态 | 调用次数 | 最近调用 |
|---|
INTEGRATION GUIDE
从拿到密钥到获取图片
以下是日常接入必需内容；字段、完整响应、错误码和 Python 示例可在 Markdown 文档中查看。
- 01创建并保存密钥
完整 API Key 只显示一次，只能放在你的服务端。
- 02准备参考图
图生图先上传文件，或者直接传入可公开访问的图片 URL。
- 03选择同步或异步
单张可同步直返图片；1-20 张批量使用异步任务并发处理。
- 04获取并保存结果
同步读取 data[0].url；异步查询到 succeeded 后读取 result.url。
接口一览
基础地址：https://image.own-jarvis.com
GET
/v1/models获取可用模型和账户实际积分价格GET
/v1/account/balance查询当前可用积分POST
/v1/files上传参考图片POST
/v1/images/generations同步生成并直接返回图片POST
/v1/images/tasks创建单张或批量任务GET
/v1/images/tasks/{task_id}查询状态和结果可用模型与积分
每张按对应积分扣除，失败自动退回。
gpt-image-21K · 0.0525 积分/张gpt-image-2-2k2K · 0.0675 积分/张gpt-image-2-4k4K · 0.0825 积分/张gpt-image-2.51K · 0.0525 积分/张gpt-image-2.5-2k2K · 0.0675 积分/张gpt-image-2.5-4k4K · 0.0825 积分/张gpt-image-2.5-flare1K · 0.1050 积分/张gpt-image-2.5-flare-2k2K · 0.1200 积分/张gpt-image-2.5-flare-4k4K · 0.1350 积分/张gpt-image-2.5-sunburst1K · 0.1050 积分/张gpt-image-2.5-sunburst-2k2K · 0.1200 积分/张gpt-image-2.5-sunburst-4k4K · 0.1350 积分/张special-gpt-image-2.51K · 0.0450 积分/张special-gpt-image-2.5-flare1K · 0.0675 积分/张special-gpt-image-2.5-sunburst1K · 0.1350 积分/张grok-imagine-image1K · 0.0600 积分/张grok-imagine-image-2.01K · 0.0750 积分/张grok-imagine-image-2.0-2k2K · 0.0825 积分/张grok-imagine-image-2.0-slow1K · 0.0450 积分/张grok-imagine-image-quality1K · 0.0900 积分/张查询账户余额
程序提交任务前可先检查积分，也可用于排查密钥或账户状态。
请求
curl 'https://image.own-jarvis.com/v1/account/balance' \ -H 'Authorization: Bearer itx_你的客户密钥'
成功响应
{
"object": "account.balance",
"data": {
"balance": "12.3456",
"unit": "points",
"account_status": "active",
"billing_multiplier": "1.0000"
}
}查询可用模型
返回该 API Key 对应账户的真实每张积分、画面比例和参考图上限。
请求
curl 'https://image.own-jarvis.com/v1/models' \ -H 'Authorization: Bearer itx_你的客户密钥'
单个模型数据
{
"id": "gpt-image-2",
"object": "model",
"display_name": "GPT-image 2.0 · 标准清晰度",
"price_points": "0.0525",
"billing_unit": "per_generation",
"max_reference_images": 10,
"supported_aspect_ratios": ["auto", "1:1", "9:16"]
}创建任务字段
不传参考图是文生图；传入 upload_ids 或 image_urls 后自动切换为图生图。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 建议填写 | 模型 ID |
prompt | string | 是 | 提示词，最长 5000 字符 |
aspect_ratio | string | 否 | 默认 auto；另支持页面列出的 11 种固定比例 |
upload_ids | string[] | 否 | 上传接口返回的文件 ID；与 image_urls 合计最多 10 张 |
image_urls | string[] | 否 | 公网可访问的 HTTP(S) 图片；与 upload_ids 合计最多 10 张 |
count | integer | 否 | 异步接口 1-20；同步接口固定为 1 |
queued已进入队列
→
running生成或保存中
→
succeeded读取 result.url
failed该张自动退回积分
FULL MARKDOWN
完整 API 调用说明
以下内容来自平台当前版本的正式客户文档。
正在加载完整 API 文档…
积分流水
预占、成功结算、失败退回与人工调整都有记录。
OPERATIONS
运营后台
管理客户、渠道归因、积分、密钥和调用毛利。
运行健康与利润保护
自动探测上游模型、熔断异常线路，并展示最近 24 小时成功率、延迟和对账结果。
上游线路
最近告警
全局模型利润表
默认客户售价与当前上游成本对比；加价率和毛利率按两种口径同时展示。
计算口径加价率 = (售价 − 上游价) ÷ 上游价毛利率 = (售价 − 上游价) ÷ 售价单个客户设置更高倍率时，实际售价会更高。
| 状态 | 渠道 / 上游 | 前端模型 | 上游模型 ID | 上游价 | 当前售价 | 单张利润 | 加价率 | 毛利率 |
|---|
客户充值记录
支付宝、微信支付的待支付与已到账订单统一在这里对账。
| 订单 / 创建时间 | 客户 | 方式 | 支付金额（人民币） | 状态 | 第三方流水号 | 到账时间 |
|---|
渠道归因与分润
专属链接会静默记录来源；成功消耗积分的 10% 计入渠道待结算分润。
| 渠道商 / 登录名 | 状态 | 专属分享链接 | 客户 | 生成调用 / 图片 | 消耗积分 / 分润积分 | 最近注册 | 操作 |
|---|
客户账户
渠道归属只在管理后台展示；倍率修改不影响历史账单。
| 客户 | 渠道 | 状态 | 积分 | 倍率 | 任务 | 消耗 / 成本积分 | 操作 |
|---|
最近调用
每条记录显示实际命中的上游网站；可直接打开或复制网址排查渠道问题。
| 任务 | 客户 | 调用来源 | 结果 | 模型 | 上游网站 | 状态 | 成本积分 | 消耗积分 | 积分毛利 |
|---|