旧版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 = "Hello, world"

# 缺少"\n\nHuman:"轮次
prompt = "Hello, world\n\nAssistant:"

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

# "\n\nHuman:"轮次不是第一个
prompt = "\n\nAssistant: Hello, world\n\nHuman: Hello, Claude\n\nAssistant:"

# "\n\nAssistant:"轮次不是最后一个
prompt = "\n\nHuman: Hello, Claude\n\nAssistant: Hello, world\n\nHuman: How many toes do dogs have?"

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

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

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

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