跳到主要内容

嵌入与图像接口

适用范围：HangToken 当前线上服务　最后核验：2026-08-26

文本嵌入​

curl https://hangtoken.com/v1/embeddings \
  -H "Authorization: Bearer sk-[你的密钥]" -H "Content-Type: application/json" \
  -d '{"model":"[嵌入模型ID]","input":["第一段文本","第二段文本"]}'

响应的 data[].embedding 是浮点数组。向量库的集合维度必须与模型输出维度一致；更换模型时通常需要重新生成全部向量。

生产建议​

  • 按模型限制切分长文本，并保存原文 ID、片段序号和模型版本。
  • 批量请求要控制单批文本数与总 Token，失败后只重试未成功批次。
  • 查询和入库必须使用同一个嵌入模型及相同预处理规则。

图像生成​

curl https://hangtoken.com/v1/images/generations \
  -H "Authorization: Bearer sk-[你的密钥]" -H "Content-Type: application/json" \
  -d '{"model":"[图像模型ID]","prompt":"绿色极简风格的产品插画","n":1,"size":"1024x1024"}'

结果可能返回临时 URL 或 Base64 数据。URL 可能过期，业务需要长期使用时应及时下载并保存到自己的对象存储。

如何确认调用成功​

  • HTTP 状态码为 200，且响应 data 数组至少包含一项。
  • 返回 URL 时应立即在有效期内下载；返回 Base64 时应先解码再保存为对应图片格式。
  • 在控制台“使用日志”中核对模型、费用、耗时和请求时间。
  • 将结果用于生产前，检查分辨率、格式、内容安全和模型许可是否符合业务要求。

尺寸、数量、格式、内容审核和计费方式因模型而异。调用前查看实时价格和模型说明，不要假设所有参数都受支持。