美团 LongCat 新用户免费额度：实名认证可领 1000 万 tokens 资源包，30 天内有效

LongCat 平台提供 OpenAI 兼容接口，接入时只需把 base_url 和 API Key 换成平台提供的即可，SDK 用法与请求体结构基本不变。

一、确认 base_url 与模型名

base_url 以控制台「API 文档 / 接入指引」页给出的完整地址为准，通常形如 https://你的控制台域名/v1，末尾带 /v1 更稳妥；不要自行猜测域名或路径。模型名同样以控制台的模型列表为准，常见为 LongCat-Flash 系列，把控制台里显示的 model 字符串原样填入请求即可，大小写敏感。

二、用 curl 发一次对话补全

先把 base_url 与密钥写入环境变量，避免密钥留在命令历史里；下面两行的值请替换成你自己的。

export LONGCAT_BASE_URL="控制台给出的 base_url"
export LONGCAT_API_KEY="你在控制台创建的 API Key"

然后发送请求：

curl "$LONGCAT_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $LONGCAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "LongCat-Flash",
    "messages": [
      {"role": "system", "content": "你是一个简洁的中文助手"},
      {"role": "user", "content": "用一句话说明什么是 API"}
    ],
    "temperature": 0.7,
    "max_tokens": 512,
    "stream": false
  }'

三、用 Python 调用

使用通用的 OpenAI 兼容 SDK，只改 base_url 与 api_key 两处：

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["LONGCAT_API_KEY"],
    base_url=os.environ["LONGCAT_BASE_URL"],
)

resp = client.chat.completions.create(
    model="LongCat-Flash",
    messages=[{"role": "user", "content": "用一句话说明什么是 API"}],
    temperature=0.7,
    max_tokens=512,
)
print(resp.choices[0].message.content)

四、关键参数说明

• model：必填，填控制台模型列表中的名称，不要照抄示例里的名字。
• messages：必填，按角色排列的对话数组，常用 system、user、assistant 三种角色。
• temperature：可选，取值越大输出越发散，常规问答建议在 0.3 到 0.7 之间。
• max_tokens：可选，限制单次回复长度，设置过小会出现回答被截断。
• stream：可选，设为 true 时以流式返回，适合做打字机效果，需要按数据块逐段解析。

五、额度耗尽与限流的典型表现与排查顺序

常见表现：返回 401 多为密钥错误或缺少 Authorization 头；返回 404 多为 base_url 拼错或漏掉 /v1；提示模型不存在则核对 model 字符串；返回 429 表示请求过快或并发受限；返回余额或配额类错误说明资源包已用尽或已过期。

1. 先看 HTTP 状态码与返回体里的错误信息，不要只看异常类型。
2. 确认密钥是否正确、是否带上了 Bearer 前缀、是否误用了已删除的密钥。
3. 确认 base_url 与控制台文档完全一致，末尾是否保留 /v1。
4. 核对 model 名称与控制台模型列表是否一字不差。
5. 去控制台的用量与资源包页面确认剩余额度与到期时间，30 天有效期过后额度会失效。
6. 若额度正常仍持续报 429，先降低并发并加重试退避，再联系平台支持。