文字補全
提示驗證
使用文本補全
舊版 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: "