快速开始

本指南将帮助您快速上手平台，从注册账号到发起第一次 API 调用，只需几分钟即可完成。

开始使用

注册账号 访问maitoken平台，点击右上角的「注册/登录」按钮，按照提示完成账号注册流程。
获取API Key 登录后，在API Key页面，点击创建 API Keys，创建一个新的 API Key。

请妥善保管您的 API Key，不要泄露给他人，也不要直接硬编码在代码中。建议使用环境变量或配置文件来存储 API Key。

令牌配置 在基本信息中填写名称、选择令牌分组（决定可用模型范围）并设置过期时间；接着在额度设置里开关总额度/月额度限制；然后在访问限制中指定支持的模型和IP白名单；最后点击提交，令牌即可按设定规则安全生效。
发起调用 准备好 API Key 和选择模型后，您可以开始发起调用。以下是使用 curl 的示例：

curl -X POST "https://{BASE_URL}/v1" -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_API_KEY" -d '{    "model": "glm-5.2",    "messages": [        {            "role": "system",            "content": "你是一个有用的AI助手。"        },        {            "role": "user",            "content": "你好，请介绍一下自己。"        }    ],    "temperature": 1.0,    "stream": true}'

相关问题

如何处理API调用错误？当 API 调用出现错误时，服务器会返回相应的 HTTP 状态码和错误信息。常见的错误包括：

401 Unauthorized: API Key 无效或已过期
400 Bad Request: 请求参数错误
429 Too Many Requests: 超出 API 调用频率限制
500 Internal Server Error: 服务器内部错误

建议实现适当的错误处理和重试机制，特别是对于 429 和 500 错误。

查阅完整错误码说明或提交工单

如何优化API调用成本？

以下是一些优化 API 调用成本的建议：

1. 选择适合任务的模型，不同模型的价格不同

2. 减少不必要的上下文信息，降低 token 消耗

3. 使用缓存机制，避免重复调用

4. 设置合理的 max\_tokens 参数，避免生成过长的回复

5. 在开发阶段使用较小的模型进行测试

如何处理长文本输入？

对于超过模型上下文窗口大小的长文本，可以采用以下策略：

1. 使用 GLM-4-Long 等支持更长上下文的模型

2. 对文本进行分段处理，然后合并结果

3. 使用文本嵌入模型进行相关性检索，只保留最相关的部分

4. 对文本进行摘要，提取关键信息后再输入模型