SuperAPI AI 工具集

claude-api

编程与开发

查看项目

更新于 10-15 20:31

技能介绍

用途:在后端/workers 中调用 Anthropic Claude,主要使用 Messages API(POST /v1/messages),官方 SDK 为 Python/TS 的 anthropic 包,也可用原始 HTTP;基址 https://api.anthropic.com。

主要能力:多轮对话;SSE 流式(stream: true);system prompt(与 messages 分离,可为字符串或块列表);工具/函数调用;视觉,图片以 image 块传入(base64 或 URL);错误处理。模型通过环境变量配置,例如 claude-sonnet-4-5 或项目固定 ID。

必要用法:认证用 x-api-key 加 anthropic-version 头。messages.create 中 max_tokens 必填;messages 的 role 为 user|assistant,内容可为文本或块;需读取 stop_reason(end_turn、tool_use、max_tokens 等)。工具调用需传 JSON Schema,若 stop_reason 为 tool_use 则在服务端执行工具,并将 tool_result 放回后续 messages,循环至 end_turn;执行副作用前先校验参数。流式使用 client.messages.stream,处理 content_block_delta 增量文本与 error 事件,客户端中断时取消上游。

适用场景:需要对话、工具调用、流式输出的后端集成。

限制与规则:API key 只能放在后端,绝不可出现在公开前端;模型 ID 固定于配置并记录升级;仅对 429、529、网络等瞬时错误做超时与退避重试,401/403 不盲目重试;不得记录含 PII/密钥的完整 prompt 与响应;按环境和功能监控 usage(输入/输出 token)。资料未提供价格、配额数值与具体版本限制等信息。