舊版 API

文本補全 API 是一個舊版 API。未來的模型和功能將需要使用 Messages API,我們建議盡快遷移

Anthropic API 會執行基本的提示清理和驗證,以確保您的提示格式適合 Claude。

在創建文本補全時,如果您的提示不符合指定的格式,API 會先嘗試輕度清理(例如,刪除尾隨空格)。這個確切的行為可能會改變,我們強烈建議您使用推薦的交替的 \n\nHuman:\n\nAssistant: 對話輪次來格式化您的提示。

然後,API 會在以下條件下驗證您的提示:

  • 提示中的第一個對話輪次必須是 \n\nHuman: 輪次
  • 提示中的最後一個對話輪次必須是 \n\nAssistant: 輪次
  • 提示的長度必須小於 100,000 - 1 個 token。

範例

以下提示會導致 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: "