从模型目录到第一次 API 请求

1. 先用一个具体任务缩小范围

把“我要试试 AI”换成一份可以检查结果的任务说明。例如：将一段产品介绍改写成 150 字以内的说明，保留指定事实，并输出三个要点。这样的任务让你更容易判断结果是否符合要求。

在模型市场按文本、图像、视频或音频选择用途，再按厂商和系列浏览。进入系列后，检查模型名称、版本、支持的输入形式，以及页面展示的价格与接口信息。

• 输入：文字、图片、音频或其他材料。
• 输出：内容形式、长度和结构。
• 约束：必须保留的事实、语言和交付要求。

2. 先读取公开目录

目录查询可以用于确认站点可访问，并了解页面对外提供的模型信息。下面的请求读取公开目录，不会执行模型生成，也不需要 API 密钥。

返回成功只说明目录请求完成。后续生成请求使用什么接口、需要哪些参数，应以所选模型的文档为准。

curl --fail --show-error \
  "https://tokvilo.com/api/model-catalog"

3. 准备账户与服务用量

注册并登录后，在控制台检查账户和可用额度。英文版提供 tokvilo 用量包在线购买或企业银行转账安排；在线支付是否开放，以支付页面和账户中显示的状态为准。

企业转账先通过支持邮箱确认企业资料、账户邮箱、购买金额和付款说明。管理员核实实际到账后，再将约定的服务用量计入指定账户。不要把提交咨询或返回付款页面当成入账成功。

• 核对当前登录邮箱，确认使用正确账户。
• 查看支付方式与账户流水，确认服务用量已到账。
• 如果页面提示服务未配置、账户异常或余额不足，先解决提示中的问题。

4. 在 Playground 检查参数与报价

从选定模型进入 Playground，先用一份短小、可验证的输入。确认模型 ID 与预期一致，再填写必要参数。模型和任务不同，表单及可填写的参数也可能不同。

报价与执行是两个步骤。获取报价后，检查金额和参数，再确认发起生成。文本长度、输出限制、图片规格或视频参数的改变可能影响报价；修改参数后应重新确认。

发起后保留原请求编号。若页面仍在处理中，先查看原请求状态；若浏览器连接中断，也不要直接把同一个任务重复提交为新请求。

5. 将确认过的请求接入应用

工作台帮助你理解模型输入和输出，但程序接入还需要查看接口文档。不同类型的模型可能使用不同协议，或采用提交任务后查询状态的异步流程。不要假设所有模型都能使用同一个请求体。

在控制台创建用于应用的 tokvilo API 密钥。将密钥保存在你的服务端环境中，避免放进公开代码仓库或浏览器前端。按照所选接口的文档处理身份验证、请求参数、错误响应和任务状态。

上线前留下一份最小验收记录：所选模型、参数、请求编号、结果是否满足任务，以及控制台的实际结算记录。这样更容易把调用问题与应用逻辑问题区分开。