旧版 API

文本补全 API 是一个旧版 API。未来的模型和功能将需要使用 消息 API,我们建议尽快迁移

Anthropic API 会执行基本的提示清理和验证,以帮助确保您的提示格式适合 Claude。

在创建文本补全时,如果您的提示不符合指定的格式,API 会首先尝试轻度清理它(例如,删除尾随空格)。这种确切行为可能会发生变化,我们强烈建议您使用推荐的交替的 \n\nHuman:\n\nAssistant: 对话轮次来格式化您的提示。

然后,API 将在以下条件下验证您的提示:

  • 提示中的第一个对话轮次必须是 \n\nHuman: 轮次
  • 提示中的最后一个对话轮次必须是 \n\nAssistant: 轮次
  • 提示的长度必须小于 100,000 - 1 个标记。

示例

以下提示将导致 API 错误

Python
# 缺少 "\n\nHuman:" 和 "\n\nAssistant:" 轮次
prompt = "你好,世界"

# 缺少 "\n\nHuman:" 轮次
prompt = "你好,世界\n\nAssistant:"

# 缺少 "\n\nAssistant:" 轮次
prompt = "\n\nHuman: 你好,Claude"

# "\n\nHuman:" 轮次不是第一个
prompt = "\n\nAssistant: 你好,世界\n\nHuman: 你好,Claude\n\nAssistant:"

# "\n\nAssistant:" 轮次不是最后一个
prompt = "\n\nHuman: 你好,Claude\n\nAssistant: 你好,世界\n\nHuman: 狗有几个脚趾?"

# "\n\nAssistant:" 只有一个 "\n"
prompt = "\n\nHuman: 你好,Claude \nAssistant:"

以下提示目前可以被 API 接受并自动清理,但您不应依赖此行为,因为它可能会在将来发生变化:

Python
# "\n\nHuman:" 前没有 "\n\n"
prompt = "Human: 你好,Claude\n\nAssistant:"

# "\n\nAssistant:" 后有尾随空格
prompt = "\n\nHuman: 你好,Claude:\n\nAssistant: "