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
  }
}

Membuat pesan menggunakan format Anthropic Messages API. Mendukung teks, gambar, PDF, alat, dan pemikiran diperluas.

Autentikasi

Authorization

string

wajib

Bearer token. Gunakan kunci API Anda sebagai bearer token di header Authorization.Format: Bearer <SUNRA_KEY>

Permintaan

Endpoint ini menerima sebuah objek.

model

string

wajib

Model yang akan menyelesaikan prompt Anda. Jelajahi model yang tersedia di sunra.ai/models.

messages

object[]

wajib

Pesan input. Setiap pesan input memiliki role dan content.

Tampilkan properties

role

string

wajib

Peran penulis pesan. Nilai yang didukung: user, assistant.

content

string | object[]

wajib

Konten pesan. Dapat berupa string tunggal atau array blok konten.

Tampilkan content block types

type

string

wajib

Tipe blok konten. Nilai yang didukung: text, image, tool_use, tool_result.

text

string

Konten teks. Digunakan ketika type adalah text.

source

object

Sumber gambar. Digunakan ketika type adalah image.

Tampilkan properties

type

string

wajib

Tipe sumber. Nilai yang didukung: base64, url.

media_type

string

wajib

Tipe media gambar. Misalnya, image/jpeg, image/png, image/gif, image/webp.

data

string

Data gambar yang di-encode base64. Diperlukan ketika tipe sumber adalah base64.

url

string

URL gambar. Diperlukan ketika tipe sumber adalah url.

max_tokens

integer

wajib

Jumlah maksimum token yang akan dihasilkan sebelum berhenti. Perhatikan bahwa model mungkin berhenti sebelum mencapai maksimum ini.

system

string | object[]

Prompt sistem. Cara untuk memberikan konteks dan instruksi kepada model. Dapat berupa string atau array blok konten.

stream

boolean

default:false

Apakah akan melakukan streaming respons secara bertahap menggunakan server-sent events (SSE).

temperature

number

default:1

Jumlah keacakan yang disuntikkan ke dalam respons. Berkisar dari 0.0 hingga 1.0. Gunakan temperature mendekati 0.0 untuk tugas analitis/pilihan ganda, dan mendekati 1.0 untuk tugas kreatif dan generatif.

top_p

number

Gunakan nucleus sampling. Dalam nucleus sampling, kami menghitung distribusi kumulatif atas semua opsi untuk setiap token berikutnya dalam urutan probabilitas menurun dan memotongnya ketika mencapai probabilitas tertentu yang ditentukan oleh top_p.

top_k

integer

Hanya ambil sampel dari K opsi teratas untuk setiap token berikutnya. Digunakan untuk menghapus respons probabilitas rendah “ekor panjang”. Disarankan hanya untuk kasus penggunaan lanjutan.

stop_sequences

string[]

Urutan teks kustom yang akan menyebabkan model berhenti menghasilkan. Teks yang dikembalikan tidak akan berisi urutan berhenti.

tools

object[]

Definisi alat yang dapat digunakan oleh model.

Tampilkan properties

name

string

wajib

Nama alat.

description

string

Deskripsi tentang apa yang dilakukan alat ini.

input_schema

object

wajib

JSON schema untuk input alat ini. Ini mendefinisikan bentuk input yang diterima oleh alat Anda.

tool_choice

object

Bagaimana model harus menggunakan alat yang disediakan.

Tampilkan properties

type

string

wajib

Nilai yang didukung: auto (default, model yang memutuskan), any (model harus menggunakan alat), tool (model harus menggunakan alat tertentu).

name

string

Nama alat yang akan digunakan. Diperlukan ketika type adalah tool.

metadata

object

Objek yang mendeskripsikan metadata tentang permintaan.

Tampilkan properties

user_id

string

Pengenal eksternal untuk pengguna yang terkait dengan permintaan.

thinking

object

Konfigurasi untuk pemikiran diperluas. Ketika diaktifkan, model akan berpikir sebelum merespons.

Tampilkan properties

type

string

wajib

Harus enabled.

budget_tokens

integer

wajib

Jumlah maksimum token yang digunakan untuk berpikir. Harus lebih besar dari atau sama dengan 1024.

Respons

Respons pesan yang berhasil.

string

Pengenal pesan unik, misalnya msg_01XFDUDYJgAACzvnptvVoYEL.

type

string

Tipe objek. Selalu message.

role

string

Peran percakapan dari pesan yang dihasilkan. Selalu assistant.

content

object[]

Konten yang dihasilkan oleh model. Ini adalah array blok konten.

Tampilkan properties

type

string

Tipe blok konten. Dapat berupa text, tool_use, atau thinking.

text

string

Teks yang dihasilkan. Ada ketika type adalah text.

string

ID blok penggunaan alat. Ada ketika type adalah tool_use.

name

string

Nama alat. Ada ketika type adalah tool_use.

input

object

Input ke alat. Ada ketika type adalah tool_use.

thinking

string

Konten pemikiran. Ada ketika type adalah thinking.

model

string

Model yang menangani permintaan.

stop_reason

string | null

Alasan model berhenti. Dapat berupa end_turn (model mencapai titik berhenti alami), max_tokens (melebihi max_tokens atau maksimum model), stop_sequence (salah satu urutan berhenti kustom Anda dihasilkan), atau tool_use (model memanggil satu atau lebih alat).

stop_sequence

string | null

Urutan berhenti kustom mana yang dihasilkan, jika ada.

usage

object

Penggunaan penagihan dan batas laju.

Tampilkan properties

input_tokens

integer

Jumlah token input yang digunakan.

output_tokens

integer

Jumlah token output yang digunakan.

cache_creation_input_tokens

integer

Jumlah token input yang digunakan untuk membuat entri cache.

cache_read_input_tokens

integer

Jumlah token input yang dibaca dari cache.

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

​Autentikasi

​Permintaan

​Respons

Autentikasi

Permintaan

Respons