# SOOLINK API 接入指南

[HTML](https://soolink.ai/guides/soolink-api.html) · [llms.txt](/llms.txt)

SOOLINK 提供多模型 API 接入、模型目录和用量计费入口。本指南帮助开发者确认模型、接口与计费单位，再开始接入。具体可用模型、接口能力与价格以模型广场和开发文档为准。

## SOOLINK 是什么？

SOOLINK 面向需要在应用中调用模型的开发者与团队。通过模型广场查看模型，在开发文档确认接口，在账户中管理 API 密钥与用量。不要把模型服务与第三方网站的会员权益混为一谈。

## 从模型选择到第一次请求

1. 打开模型广场，确认模型 ID、任务类型和计费单位。
2. 在账户中创建 API 密钥。
3. 从开发文档复制当前 Base URL 与对应接口示例。
4. 在服务端配置密钥并发起请求。
5. 在账户用量记录中核对结果。

> 不要在浏览器前端或公开仓库暴露密钥。使用示例时替换占位值。

## 选择正确接口

公开文档列有模型列表、对话、向量、图像、语音、视频等接口。支持范围因模型而异；端点存在不代表每个模型支持所有任务。

- `GET /v1/models`
- `POST /v1/chat/completions`
- `POST /v1/embeddings`
- `POST /v1/images/generations`
- `POST /v1/audio/speech`
- `POST /v1/videos`

## 如何理解费用

按所选模型的公开价格和计费单位计算，文本与任务型模型的单位可能不同。接入前查看输入、输出、缓存及视频时长等适用项；实际费用以对应账单为准。充值与实际消费不同。此页不维护静态价格表，不作折扣或收益承诺。

## 常见问题

**如何知道模型能否使用？**

查看当前模型目录及密钥可访问的模型。

**是否所有模型兼容同一接口？**

不是，按模型查开发文档。

**请求失败如何排查？**

先检查模型 ID、端点、密钥权限、余额和返回错误信息，不公开密钥。

**价格变化以哪里为准？**

当前模型目录和对应账单，不能用这份说明作为固定报价。

## 下一步

- [模型广场](/pricing)
- [开发文档](/docs)
- [返回官网](/)