POST
/
v1
/
experimental
/
templatize_prompt
cURL
curl -X POST https://api.anthropic.com/v1/experimental/templatize_prompt \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "anthropic-beta: prompt-tools-2025-04-02" \
     --header "content-type: application/json" \
     --data \
'{
    "messages": [{"role": "user", "content": "Translate hello to German"}],
    "system": "You are an English to German translator"
}'
{
  "messages": [
    {
      "content": [
        {
          "text": "Translate {{WORD_TO_TRANSLATE}} to {{TARGET_LANGUAGE}}",
          "type": "text"
        }
      ],
      "role": "user"
    }
  ],
  "system": "You are a professional English to {{TARGET_LANGUAGE}} translator",
  "usage": [
    {
      "input_tokens": 490,
      "output_tokens": 661
    }
  ],
  "variable_values": {
    "TARGET_LANGUAGE": "German",
    "WORD_TO_TRANSLATE": "hello"
  }
}
As APIs de ferramentas de prompt estão em uma prévia de pesquisa fechada. Solicite para participar da prévia de pesquisa fechada.

Antes de começar

As ferramentas de prompt são um conjunto de APIs para gerar e melhorar prompts. Ao contrário de nossas outras APIs, esta é uma API experimental: você precisará solicitar acesso, e ela não tem o mesmo nível de compromisso com suporte de longo prazo que outras APIs. Essas APIs são similares ao que está disponível no Anthropic Workbench, e são destinadas para uso por outras plataformas de engenharia de prompt e playgrounds.

Começando com o melhorador de prompt

Para usar a API de geração de prompt, você precisará:
  1. Ter participado da prévia de pesquisa fechada para as APIs de ferramentas de prompt
  2. Usar a API diretamente, em vez do SDK
  3. Adicionar o cabeçalho beta prompt-tools-2025-04-02
Esta API não está disponível no SDK

Criar template de um prompt

Headers

anthropic-beta
string[]

Optional header to specify the beta version(s) you want to use.

To use multiple betas, use a comma separated list like beta1,beta2 or specify the header multiple times for each beta.

x-api-key
string
required

Your unique API key for authentication.

This key is required in the header of all API requests, to authenticate your account and access Anthropic's services. Get your API key through the Console. Each key is scoped to a Workspace.

Body

application/json

Response

Successful Response

The response is of type object.