用你自己的程序调用
出图、平台视频、写作和配音都可以用接口调。余额、会员和软件里是同一个账号,生图和视频按下面的 API 价格收,没生成成功的自动退回;每一次调用都记在 API 控制台的「生成记录」和「扣费记录」里(软件里也看得到)。
开始之前
三件事:一把 Key、一个地址、一个请求头
用激活码登录 API 控制台 →「API Key」→「新建 Key」(也可以在软件左侧「API 接口」里建)。完整的 Key 只显示这一次,复制保存好;丢了就停用再建一把(每个账号最多 5 把)。
https://www.9a.ink/api/v1/open
Authorization: Bearer mjk_…
请求和返回都是 JSON(上传参考图除外)。
Key 等于你的余额:不要写进网页前端、不要发给别人。怀疑泄露了就在 API 控制台(或软件里)停用它,立刻失效。
出一张图(完整例子)
全部是异步的:下单立刻返回任务 ID,然后隔几秒查一次,出结果为止(出图一般 1~4 分钟)
import time, requests
BASE = "https://www.9a.ink/api/v1/open"
H = {"Authorization": "Bearer mjk_你的Key"}
# 1. 下单(立刻返回,不用等)
r = requests.post(f"{BASE}/images", headers=H, json={
"model": "ninea-image",
"prompt": "古风少女,白衣,站在桃花树下,全身像",
"aspect_ratio": "9:16",
"count": 1,
})
r.raise_for_status()
job = r.json()["job"]
# 2. 每隔 3 秒查一次,出结果为止
while job["status"] == "active":
time.sleep(3)
job = requests.get(f"{BASE}/jobs/" + job["id"], headers=H).json()["job"]
if job["status"] in ("succeeded", "partial"):
for item in job["output"]["results"]:
print(item["url"]) # 60 分钟内有效,不用带 Key 就能下载
else:
print(job["error"]["message"]) # 没成功的已经自动退款
用 curl:
curl -X POST "https://www.9a.ink/api/v1/open/images" \
-H "Authorization: Bearer mjk_你的Key" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 6f1c2b7e-0d3a-4a8e-9c1f-2b9e8d7a6c55" \
-d '{"model":"ninea-image","prompt":"古风少女,白衣,站在桃花树下","aspect_ratio":"9:16"}'
curl "https://www.9a.ink/api/v1/open/jobs/任务ID" -H "Authorization: Bearer mjk_你的Key"
接口一览
地址都在 https://www.9a.ink/api/v1/open 下面
| 方法 | 路径 | 做什么 |
|---|---|---|
| GET | /models | 现在能用的档位与售价(下单时 model 填这里的值) |
| GET | /balance | 余额(单位:分)与会员是否有效 |
| POST | /uploads | 上传一张参考图(multipart,字段 file),返回 id,填进下单的 reference_ids |
| POST | /images | 出图(按张计费) |
| POST | /videos | 平台视频(按条计费,一次一条) |
| POST | /chat | 写作(大模型对话,按实际用量计费) |
| POST | /speech | 配音(按字数计费) |
| GET | /jobs/{id} | 一个任务的进度、结果、花了多少 |
| GET | /jobs | 生成记录:成功、失败、进行中的都在(含在软件里点的) |
| POST | /jobs/{id}/cancel | 取消:还没出结果的全额退回 |
| GET | /ledger | 扣费记录:每一笔扣费、退回、充值 |
下单的参数
带 * 的必填;其余不填就用档位的默认值
model* 档位(GET /models 里的 model)prompt* 画面描述negative_prompt不想出现的内容aspect_ratio画面比例,例如 9:16、16:9、1:1count张数,默认 1(不超过档位的 max_count)reference_ids参考图(先 POST /uploads 拿 id)
model* 视频档位prompt* 视频提示词duration秒数(只能是档位 durations 里的值)aspect_ratio、reference_ids同上
model* 写作档位messages* 对话,例如 [{"role": "user", "content": "……"}](role 可以是 system / user / assistant)max_output最多输出多少 token,temperature0~2,jsontrue = 要求输出 JSON- 先按「输入字数 + 最大输出」预扣,结束后按实际用量多退少补;结果在 output.text
model* 配音档位,text* 一句台词voice音色(档位的 voices 里的 id),speed语速 0.5~2- 结果在 output.audio.url(60 分钟内有效)
下单时带请求头 Idempotency-Key: 一个 UUID(8~60 位字母、数字或 _ . : -)。网络断了重试时带同一个值,只会拿回第一次的任务,不会再扣一次钱;不带就每次都是新任务。
不带就按当前 API 售价扣。想保证「价格变了就不要下单」:出图、视频带 expected_unit_price_cents,写作、配音带 expected_price_version(GET /models 里的 price.version);价格变了会返回 409 PRICE_CHANGED,不扣钱。
active 排队 / 生成中 · succeeded 成功 · partial 部分成功(没出来的那几张已退款)· failed 失败(全额退回,原因在 error.message)· cancelled 已取消(全额退回)
deducted_cents 下单时扣的(写作、配音是预扣的上限)· refunded_cents 退回的 · spent_cents 实际花的。单位都是「分」。可以带 client_ref(最多 64 字)记上你自己的编号,查记录时原样带回。
现在能用的档位与价格
实时的 API 价格;程序里用 GET /models 取,价格单位是分
| 类型 | model | 名称 | 价格 | 说明 |
|---|---|---|---|---|
| 出图 | ninea-image | gpt-image-2 | ¥0.10 / 张 | 一次最多 2 张,比例 9:16 16:9 1:1 3:4 4:3 2:3 3:2 21:9,参考图最多 8 张 |
| 出图 | standard | 标准 | ¥0.10 / 张 | 一次最多 4 张,比例 9:16 16:9 1:1 3:4 4:3 2:3 3:2 21:9,参考图最多 12 张 |
| 视频 | relay-sd25 | Seedance 2.5 · 5~30 秒 | ¥6.80 / 条 | 5 / 10 / 15 / 20 / 25 / 30 秒,比例 9:16 16:9 1:1 3:4 4:3 21:9,参考图最多 9 张 |
| 视频 | relay-minimax-h3 | MiniMax H3 · 15 秒 | ¥0.20 / 条 | 15 秒,比例 9:16 16:9 1:1 3:4 4:3 21:9,参考图最多 9 张 |
| 写作 | ninea-gpt6 | gpt-6 | 每千 token:输入 0.2000 分 / 输出 0.8000 分 | 一次最多 200000 字,每次最少 1 分 |
出错时
返回 {"error": {"code", "message", "hint", "details"}},按 code 判断,message / hint 可以直接给人看
| HTTP | code | 什么情况 |
|---|---|---|
| 401 | API_KEY_INVALID | 没带 Key、Key 不对或已经停用 |
| 402 | INSUFFICIENT_BALANCE | 余额不够(不会建任务、不扣钱) |
| 403 | LICENSE_EXPIRED | 软件时长到期了、或者还没开通(在 API 控制台「充值」兑换时长卡) |
| 403 | ACCOUNT_BANNED | 账号已被停用 |
| 404 | NOT_FOUND | 任务 ID 不对,或者不是这个账号的任务 |
| 409 | PRICE_CHANGED | 带了 expected_* 而价格刚调整过(不扣钱,确认新价格后再下单) |
| 422 | VALIDATION_FAILED | 参数不对(message 里写了是哪一个) |
| 422 | IDEMPOTENCY_KEY_REUSED | 同一个 Idempotency-Key 换了内容 |
| 429 | TOO_MANY_ATTEMPTS | 请求太频繁(每把 Key 每分钟 120 次) |
| 429 | TOO_MANY_ACTIVE_JOBS | 同时进行的任务太多了,等前面的出结果再交 |
| 503 | API_DISABLED | 对外接口暂时关闭 |
| 503 | MODEL_UNAVAILABLE / AI_UNAVAILABLE | 这个档位暂时不能用(换一个,或稍后再试) |
余额用完了
在 API 控制台「充值」(或软件「我的账号」)兑换卡密,余额立刻能用
联系卖家购买激活码、充值卡。
- · 每把 Key 每分钟最多 120 次请求(查任务也算),轮询隔 2~5 秒就够了
- · 同时进行的任务数和软件里一样,超了返回 429 TOO_MANY_ACTIVE_JOBS
- · 结果下载地址 60 分钟内有效,过期了再查一次任务就是新地址