漫剧助手 接口文档

用你自己的程序调用

出图、平台视频、写作和配音都可以用接口调。余额、会员和软件里是同一个账号,生图和视频按下面的 API 价格收,没生成成功的自动退回;每一次调用都记在 API 控制台的「生成记录」和「扣费记录」里(软件里也看得到)。

开始之前

三件事:一把 Key、一个地址、一个请求头

1
建一把 Key

用激活码登录 API 控制台 →「API Key」→「新建 Key」(也可以在软件左侧「API 接口」里建)。完整的 Key 只显示这一次,复制保存好;丢了就停用再建一把(每个账号最多 5 把)。

2
接口地址

https://www.9a.ink/api/v1/open

3
每个请求带上 Key

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 扣费记录:每一笔扣费、退回、充值

下单的参数

带 * 的必填;其余不填就用档位的默认值

POST /images
  • model* 档位(GET /models 里的 model)
  • prompt* 画面描述
  • negative_prompt 不想出现的内容
  • aspect_ratio 画面比例,例如 9:16、16:9、1:1
  • count 张数,默认 1(不超过档位的 max_count)
  • reference_ids 参考图(先 POST /uploads 拿 id)
POST /videos
  • model* 视频档位
  • prompt* 视频提示词
  • duration 秒数(只能是档位 durations 里的值)
  • aspect_ratio、reference_ids 同上
POST /chat
  • model* 写作档位
  • messages* 对话,例如 [{"role": "user", "content": "……"}](role 可以是 system / user / assistant)
  • max_output 最多输出多少 token,temperature 0~2,json true = 要求输出 JSON
  • 先按「输入字数 + 最大输出」预扣,结束后按实际用量多退少补;结果在 output.text
POST /speech
  • model* 配音档位,text* 一句台词
  • voice 音色(档位的 voices 里的 id),speed 语速 0.5~2
  • 结果在 output.audio.url(60 分钟内有效)
防重复扣费:Idempotency-Key(建议带)

下单时带请求头 Idempotency-Key: 一个 UUID(8~60 位字母、数字或 _ . : -)。网络断了重试时带同一个值,只会拿回第一次的任务,不会再扣一次钱;不带就每次都是新任务。

价格确认(可选)

不带就按当前 API 售价扣。想保证「价格变了就不要下单」:出图、视频带 expected_unit_price_cents,写作、配音带 expected_price_version(GET /models 里的 price.version);价格变了会返回 409 PRICE_CHANGED,不扣钱。

任务的 status

active 排队 / 生成中 · succeeded 成功 · partial 部分成功(没出来的那几张已退款)· failed 失败(全额退回,原因在 error.message)· cancelled 已取消(全额退回)

花了多少:cost

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 可以直接给人看

HTTPcode什么情况
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 分钟内有效,过期了再查一次任务就是新地址