Create a message - Sunra.ai

curl -X POST https://api-llm.sunra.ai/v1/messages \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Hello, how are you?"
      }
    ]
  }'

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! I'm doing well, thank you for asking. How can I help you today?"
    }
  ],
  "model": "anthropic/claude-sonnet-4-20250514",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 19
  }
}

POST

messages

curl -X POST https://api-llm.sunra.ai/v1/messages \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Hello, how are you?"
      }
    ]
  }'

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! I'm doing well, thank you for asking. How can I help you today?"
    }
  ],
  "model": "anthropic/claude-sonnet-4-20250514",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 19
  }
}

Anthropic Messages API 형식을 사용하여 메시지를 생성합니다. 텍스트, 이미지, PDF, 도구 및 확장 사고를 지원합니다.

인증

Authorization

string

필수

Bearer 토큰. API 키를 Authorization 헤더의 Bearer 토큰으로 사용하세요.Format: Bearer <SUNRA_KEY>

요청

이 엔드포인트는 JSON 객체를 받습니다.

model

string

필수

프롬프트를 완성할 모델. 사용 가능한 모델은 sunra.ai/models에서 확인하세요.

messages

object[]

필수

입력 메시지. 각 입력 메시지에는 role과 content가 있습니다.

표시 속성

role

string

필수

메시지 작성자의 역할. 지원되는 값: user, assistant.

content

string | object[]

필수

메시지의 내용. 단일 문자열 또는 콘텐츠 블록 배열을 지정할 수 있습니다.

표시 콘텐츠 블록 유형

type

string

필수

콘텐츠 블록의 유형. 지원되는 값: text, image, tool_use, tool_result.

text

string

텍스트 콘텐츠. type이 text인 경우 사용됩니다.

source

object

이미지 소스. type이 image인 경우 사용됩니다.

표시 속성

type

string

필수

소스 유형. 지원되는 값: base64, url.

media_type

string

필수

이미지의 미디어 유형. 예: image/jpeg, image/png, image/gif, image/webp.

data

string

Base64로 인코딩된 이미지 데이터. 소스 유형이 base64인 경우 필수입니다.

url

string

이미지 URL. 소스 유형이 url인 경우 필수입니다.

max_tokens

integer

필수

중단 전에 생성할 최대 토큰 수. 모델이 이 최대값에 도달하기 전에 중단할 수 있습니다.

system

string | object[]

시스템 프롬프트. 모델에 컨텍스트와 지침을 제공하는 방법입니다. 문자열 또는 콘텐츠 블록 배열을 지정할 수 있습니다.

stream

boolean

기본값:false

서버 전송 이벤트(SSE)를 사용하여 응답을 점진적으로 스트리밍할지 여부.

temperature

number

기본값:1

응답에 주입되는 무작위성의 양. 0.0에서 1.0 범위. 분석/객관식 작업에는 0.0에 가까운 temperature를, 창의적이고 생성적인 작업에는 1.0에 가까운 값을 사용하세요.

top_p

number

핵 샘플링을 사용합니다. 핵 샘플링에서는 확률이 감소하는 순서로 각 후속 토큰의 모든 옵션에 대한 누적 분포를 계산하고 top_p로 지정된 특정 확률에 도달하면 중단합니다.

top_k

integer

각 후속 토큰에 대해 상위 K개의 옵션에서만 샘플링합니다. 확률이 낮은 “롱테일” 응답을 제거하는 데 사용됩니다. 고급 사용 사례에만 권장됩니다.

stop_sequences

string[]

모델의 생성을 중단시키는 사용자 정의 텍스트 시퀀스. 반환된 텍스트에는 중단 시퀀스가 포함되지 않습니다.

tools

object[]

모델이 사용할 수 있는 도구 정의.

표시 속성

name

string

필수

도구의 이름.

description

string

이 도구가 수행하는 작업에 대한 설명.

input_schema

object

필수

이 도구의 입력에 대한 JSON 스키마. 도구가 허용하는 input의 형태를 정의합니다.

tool_choice

object

모델이 제공된 도구를 어떻게 사용할지 지정합니다.

표시 속성

type

string

필수

지원되는 값: auto(기본값, 모델이 결정), any(모델이 반드시 도구를 사용해야 함), tool(모델이 특정 도구를 사용해야 함).

name

string

사용할 도구의 이름. type이 tool인 경우 필수입니다.

metadata

object

요청에 대한 메타데이터를 설명하는 객체.

표시 속성

user_id

string

요청과 연결된 사용자의 외부 식별자.

thinking

object

확장 사고 구성. 활성화하면 모델이 응답하기 전에 사고합니다.

표시 속성

type

string

필수

반드시 enabled여야 합니다.

budget_tokens

integer

필수

사고에 사용할 최대 토큰 수. 1024 이상이어야 합니다.

응답

메시지 성공 응답.

string

고유 메시지 식별자. 예: msg_01XFDUDYJgAACzvnptvVoYEL.

type

string

객체 유형. 항상 message.

role

string

생성된 메시지의 대화 역할. 항상 assistant.

content

object[]

모델이 생성한 콘텐츠. 콘텐츠 블록의 배열입니다.

표시 속성

type

string

콘텐츠 블록의 유형. text, tool_use, 또는 thinking일 수 있습니다.

text

string

생성된 텍스트. type이 text인 경우 존재합니다.

string

도구 사용 블록의 ID. type이 tool_use인 경우 존재합니다.

name

string

도구의 이름. type이 tool_use인 경우 존재합니다.

input

object

도구에 대한 입력. type이 tool_use인 경우 존재합니다.

thinking

string

사고 내용. type이 thinking인 경우 존재합니다.

model

string

요청을 처리한 모델.

stop_reason

string | null

모델이 중단한 이유. end_turn(모델이 자연스러운 중단점에 도달), max_tokens(max_tokens 또는 모델의 최대값 초과), stop_sequence(사용자 정의 중단 시퀀스 중 하나가 생성됨), 또는 tool_use(모델이 하나 이상의 도구를 호출함)일 수 있습니다.

stop_sequence

string | null

생성된 사용자 정의 중단 시퀀스(해당하는 경우).

usage

object

청구 및 속도 제한 사용량.

표시 속성

input_tokens

integer

사용된 입력 토큰 수.

output_tokens

integer

사용된 출력 토큰 수.

cache_creation_input_tokens

integer

캐시 항목을 생성하는 데 사용된 입력 토큰 수.

cache_read_input_tokens

integer

캐시에서 읽은 입력 토큰 수.

curl -X POST https://api-llm.sunra.ai/v1/messages \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Hello, how are you?"
      }
    ]
  }'

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! I'm doing well, thank you for asking. How can I help you today?"
    }
  ],
  "model": "anthropic/claude-sonnet-4-20250514",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 19
  }
}

Create a chat completion Create a response

​인증

​요청

​응답

인증

요청

응답