anthropic@v1

Communicate with Anthropic's Messages API, no API key needed.

Parameters

Every parameter that accepts ${{ }} can be computed from an expression.

How it works

The request is the body of the Messages API (POST /v1/messages), sent as is: model, max_tokens, system, messages... The result has the fields of the response (content, stop_reason, usage...) and ok.

Nothing to set up: without secret, no API key is needed and Callr bills the tokens per model (see the AI section of your rates, Billing > Pricing). properties.model must then be one of the Anthropic models listed in the AI section of your rates (Billing > Pricing). Without properties.model, the default model of your account answers when it is an Anthropic one, else claude-sonnet-5-5. When the model asked is no longer available (deprecated by Anthropic), the closest model answers instead.

Your own Anthropic API key (optional): with secret, Anthropic bills the tokens on your account, and any model you have access to works.

Examples

No API key needed

No key and no model: the default model of your account answers, the tokens are billed by Callr. The reply is in content[0].text.

- label: ask
  action: recognize@v3
  params:
    tts:
      text: Ask me anything
  result: $question

- action: anthropic@v1
  params:
    properties:
      max_tokens: 200
      system: You answer on the phone, in one short sentence.
      messages:
        - role: user
          content: ${{ $question.text }}
    timeout: 10
    # feedback: sound played to the caller while waiting for Anthropic,
    # disabled by default
    feedback:
      enabled: true
      sound: heartbeat
  result: $anthropic

- if: >
    !$anthropic.ok || !$anthropic?.content?.length
  then:
    - action: play@v3
      params:
        tts:
          text: I am sorry, I was not able to reply within the time limit.
    - goto:
        label: ask

- action: play@v3
  params:
    tts:
      text: ${{ $anthropic.content?.[0]?.text }}

With your Anthropic key

With secret, Anthropic bills your account: keep the key in the secrets of the account (Secrets button of the Actions page) rather than in the scenario.

- action: anthropic@v1
  params:
    secret: ${{ secrets.ANTHROPIC_KEY }}
    properties:
      model: claude-sonnet-5-5
      max_tokens: 1024
      messages:
        - role: user
          content: Hello
  result: $anthropic

Result

Set result: $myVariable to keep it. Response of the Anthropic Messages API. On success, the fields of the response (id, content, stop_reason, usage...) and ok: true

{
  "ok": true,
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [
    { "type": "text", "text": "Hello! How can I help you today?" }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 10
  }
}