Langsung ke konten utama
POST
/
v1
/
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.
​
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.
​
tool_choice
object
Bagaimana model harus menggunakan alat yang disediakan.
​
metadata
object
Objek yang mendeskripsikan metadata tentang permintaan.
​
thinking
object
Konfigurasi untuk pemikiran diperluas. Ketika diaktifkan, model akan berpikir sebelum merespons.

​
Respons

Respons pesan yang berhasil.
​
id
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.
​
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.
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
  }
}