API 参考 / 模型

查看模型规格

getModel

GET/v1/models/{id}

下面的接口说明为英文原文。

Read accessible specifications for one model

Markdown 文件在 Playground 试运行文档版本 r8

鉴权

在请求头带上项目 API Key，例如 Authorization: Bearer $VIZO_API_KEY。API Key 只放在服务端。

路径参数

路径参数
字段	说明
idstring必填	资源 ID，收到后立即保存。

响应

200 OK

字段说明

entriesobject[], 可为 null必填

entries 的字段

asOfdate-time必填

featuresstring[], 可为 null必填

inputSchemaany必填

mediaTypestring必填

modelIdstring必填

tiersobject[], 可为 null必填

tiers 的字段

idstring必填

matchmap<string, any>必填

pricingobject必填

pricing 的字段

comparisonobject可选

comparison 的字段

comparison 的字段
officialobject必填
officialRequestAmountstring可选
ourAmountstring可选
referencePackobject可选
savingsPercentstring可选

creditsstring必填

imageobject可选

image 的字段

image 的字段
extra_input_creditsstring可选
free_input_imagesinteger必填
large_creditsstring可选
max_outputsinteger必填
output_creditsstring必填

kindstring必填

rateobject可选

rate 的字段

rate 的字段
auto_durationboolean必填
counts_inputboolean必填
credits_per_secondstring必填
max_input_secondsinteger必填
max_secondsinteger必填
min_secondsinteger必填

usdobject必填

usd 的字段

usd 的字段
amountstring可选	格式`^(0\|[1-9][0-9]*)([.][0-9]+)?$`
as_ofdate-time可选
basisstring可选	`current_standard_pack`
statusstring必填	Available when a current USD reference pack supplies the estimate; unavailable when no valid reference exists. This is a display estimate, not the charge. `availableunavailable`
tax_includedboolean必填	`false`

next_cursorstring可选

作为 cursor 传入以读取下一页。最后一页为空。

错误

所有错误使用同一种响应体。联系支持时请附上 request_id。

错误响应体

字段说明

errorobject必填

错误详情。

error 的字段

codestring必填

Stable request error code. invalid_input rejects the request schema; invalid_credentials/scope_denied reject authentication/authorization; ip_not_allowed/model_not_allowed reject API key IP/model restrictions; resource_not_found hides missing or inaccessible resources; conflict rejects incompatible state; insufficient_balance/budget_exceeded/spending_blocked reject funding; balance_negative (402) refuses new tasks while the organization owes Credits from a charge above its hold, until a top-up repays them; rate_limited/concurrency_limited ask for a later retry; temporarily_unavailable is transient service capacity; request_failed covers other HTTP failures. tier_not_sold, draft_not_found, draft_expired and input_duration_out_of_range reject model-specific input. input_media_invalid rejects a detected format/type mismatch; input_media_too_large rejects a probed byte size above the model limit. storage_quota_exceeded rejects an upload when the organization's storage is full. See errors for field-level details.

invalid_inputinvalid_credentialsinsufficient_balancebalance_negativescope_deniedresource_not_foundconflictrate_limitedconcurrency_limitedtemporarily_unavailablerequest_failedip_not_allowedmodel_not_allowedtier_not_solddraft_not_founddraft_expiredinput_duration_out_of_rangeinput_media_invalidinput_media_too_largebudget_exceededspending_blockedstorage_quota_exceeded

errorsobject[], 可为 null可选

errors 的字段

errors 的字段
pathstring必填
rulestring必填

messagestring必填

可读的说明，不要解析它。

request_idstring必填

联系支持时请附上。

retryableboolean必填

仅 429 和 503 为 true。即便如此，重发创建请求前也要先查看近期任务。

task_idstring可选

错误所属的任务（如果有）。

错误
状态码	含义与处理
401	API Key 缺失、格式错误、已过期或已撤销。在服务端更正 API Key 后继续。
403	API Key 权限、邮箱验证、预算上限或账户限制阻止了操作。检查 API Key 类型、权限和项目预算。
404	模型或资源不存在，或不在当前项目范围内。确认项目、ID 和模型是否已开通。
422	字段或取值无效。对照字段表和模型页修改请求。
500	服务端出错，任务可能已经受理。不要直接重发，先查看近期任务。
503	服务暂时不可用。创建请求要先查看近期任务，确认没有受理，再重新提交。

请求示例

cURL

curl "https://api.vizoapi.com/v1/models/$MODEL_ID" \
  -H "Authorization: Bearer $VIZO_API_KEY"

Python

import os, requests

model_id = "…"
res = requests.get(
    f"https://api.vizoapi.com/v1/models/{model_id}",
    headers={"Authorization": f"Bearer {os.environ['VIZO_API_KEY']}"},
    timeout=60,
)
print(res.status_code, res.json())

Node.js

const model_id = "…";
const res = await fetch(`https://api.vizoapi.com/v1/models/${model_id}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.VIZO_API_KEY}`,
  },
});
console.log(res.status, await res.json());

响应 200

{
  "entries": [
    {
      "asOf": "2026-11-02T08:00:00Z",
      "features": [
        "string"
      ],
      "inputSchema": {},
      "mediaType": "string",
      "modelId": "string",
      "tiers": [
        {
          "id": null,
          "match": null,
          "pricing": null
        }
      ]
    }
  ],
  "next_cursor": ""
}

响应 401

{
  "error": {
    "code": "invalid_credentials",
    "message": "API key is missing, malformed, expired or revoked.",
    "retryable": false,
    "request_id": "9f2c41d07ab3e5c8"
  }
}

响应 403

{
  "error": {
    "code": "scope_denied",
    "message": "The key does not allow this operation for this project.",
    "retryable": false,
    "request_id": "9f2c41d07ab3e5c8"
  }
}

响应 404

{
  "error": {
    "code": "resource_not_found",
    "message": "The resource is not available to this project.",
    "retryable": false,
    "request_id": "9f2c41d07ab3e5c8"
  }
}

响应 422

{
  "error": {
    "code": "invalid_input",
    "message": "Input does not match the published schema.",
    "retryable": false,
    "request_id": "9f2c41d07ab3e5c8"
  }
}

响应 500

{
  "error": {
    "code": "request_failed",
    "message": "The request failed. Check recent generations before submitting again.",
    "retryable": false,
    "request_id": "9f2c41d07ab3e5c8"
  }
}

响应 503

{
  "error": {
    "code": "temporarily_unavailable",
    "message": "Service is temporarily unavailable.",
    "retryable": true,
    "request_id": "9f2c41d07ab3e5c8"
  }
}