Nekorb AI
登录注册
开发者 API

API 文档

登录后创建 API Key，再通过 Bearer 鉴权调用 Nekorb AI v1 接口。API Key 明文只显示一次。

鉴权方式

在 Authorization header 中传入 API Key。数据库只保存 hash 和前缀。

API Key 已启用
Authorization: Bearer YOUR_API_KEY
POST

/v1/text/generate

使用 Bearer API Key 发起 DeepSeek 文本生成；账户需要有 Credits。

GET

/v1/balance

返回当前账户真实可用、预留和总 Credits。

GET

/v1/usage

返回 Credits 流水和任务消耗记录。

文本生成请求

POST /v1/text/generate
Content-Type: application/json

{
  "idempotency_key": "your-unique-request-id",
  "prompt": "Write a short product summary."
}

当前报价为 100 Credits。若 DeepSeek 失败、超时或返回异常，已预留 Credits 会自动返还。

curl 示例

curl https://ai.nekorbai.com/v1/text/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "idempotency_key": "demo-request-001",
    "prompt": "请用一句话介绍 Nekorb AI。"
  }'

idempotency_key

同一用户重复提交相同 idempotency_key 不应重复扣费。重复请求会返回已有任务状态，并记录 repeated_idempotency_key 风险事件。

Credits 扣费

text_generate 当前 quote 为 100 Credits。执行前 reserve，成功 settle，provider 失败 release 返还。

错误码

missing_bearer_auth
invalid_api_key
api_key_disabled
insufficient_credits
prompt_too_long
daily_user_call_limit_exceeded
daily_api_key_call_limit_exceeded
provider_auth_error
provider_timeout
provider_rate_limited
provider_5xx
provider_bad_response

支付暂未开放；当前 API 仅支持已接入的文本生成、余额和用量查询。