快速开始

ModelPort API 文档

使用说明

创建密钥，查询可用模型，然后提交任务。

先创建 API 密钥，将它设为环境变量 MODELPORT_API_KEY。从目录响应中选择 available: true 的模型。

OpenAI 兼容 SDK 的 base_url 填 https://api.apimodel.store/v1。Anthropic SDK 的 base_url 填 https://api.apimodel.store，客户端会补上 /v1/messages。

也可使用 https://apimodel.store/api/v1。各入口共用 API 密钥、余额和账单，同一个任务继续使用原幂等键和任务编号。

创建 API 密钥配置客户端

读取模型目录

curl "https://apimodel.store/v1/models" \
  -H "Authorization: Bearer $MODELPORT_API_KEY"

查询任务报价

curl "https://apimodel.store/v1/quotes" \
  -H "Authorization: Bearer $MODELPORT_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model":"nano-banana-2-1","prompt":"A ceramic cup in morning light.","parameters":{"resolution":"1K"}}'

确认费用后，将下列示例的 max_price_usd 改为你接受的上限。提交成功后，把返回的 id 设为 MODELPORT_JOB_ID。

提交已报价任务

curl "https://apimodel.store/v1/jobs" \
  -H "Authorization: Bearer $MODELPORT_API_KEY" \
  -H "Idempotency-Key: image-example-01" \
  -H "Content-Type: application/json" \
  --data '{"model":"nano-banana-2-1","prompt":"A ceramic cup in morning light.","parameters":{"resolution":"1K"},"max_price_usd":"0.05"}'

查询任务状态

curl "https://apimodel.store/v1/jobs/$MODELPORT_JOB_ID" \
  -H "Authorization: Bearer $MODELPORT_API_KEY"