Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

The Responses API adalah API percakapan stateful terbaru dari OpenAI. TokenLab mendukung format ini sebagai jalur opsional lanjutan untuk model yang kompatibel; gunakan POST /v1/chat/completions sebagai jalur default yang kompatibel dengan OpenAI kecuali Anda secara eksplisit memerlukan perilaku khusus Responses.

​
Isi Permintaan

​
model
string
wajib
ID model yang akan digunakan. Lihat Models untuk opsi yang tersedia.
​
input
array
wajib
Daftar item input yang membentuk percakapan.Setiap item dapat berupa:
  • message: Sebuah pesan percakapan dengan role dan content
  • function_call: Permintaan pemanggilan fungsi
  • function_call_output: Output dari pemanggilan fungsi
Untuk input multimodal, message.content dapat berupa string biasa atau array blok konten. Untuk model yang mendukung gambar seperti varian GPT-5.4, kirim gambar sebagai blok input_image alih-alih menyematkan URL atau string Base64 langsung ke dalam teks biasa.Contoh blok konten:
  • { "type": "input_text", "text": "Describe this image" }
  • { "type": "input_image", "image_url": "https://example.com/image.jpg" }
  • { "type": "input_image", "image_url": "data:image/png;base64,..." }
​
instructions
string
Instruksi sistem untuk model (setara dengan pesan sistem).
​
max_output_tokens
integer
Jumlah maksimum token yang akan dihasilkan.
​
temperature
number
default:"1"
Sampling temperature antara 0 dan 2.
​
tools
array
Daftar tools yang mungkin dipanggil oleh model.Untuk tool hosted image_generation yang memakai model tool gambar default atau secara eksplisit menyetel model: "gpt-image-2", TokenLab menghapus input_fidelity yang tidak didukung sebelum meneruskan request karena GPT Image 2 sudah memperlakukan input gambar sebagai high fidelity. Jangan kirim background: "transparent" untuk tool ini; TokenLab tidak menghapusnya diam-diam karena itu mengubah semantik output.
​
stream
boolean
default:"false"
Jika true, mengembalikan aliran events.
​
previous_response_id
string
ID dari respons sebelumnya untuk melanjutkan percakapan.
​
store
boolean
default:"true"
Menentukan apakah respons disimpan untuk pengambilan nanti.
​
metadata
object
Metadata yang dilampirkan pada respons untuk keperluan pelacakan.
​
text
object
Opsi konfigurasi untuk generasi teks. Perilaku text.format bergantung pada model dan jalur yang dipilih; tidak dijamin seragam di setiap model.
​
parallel_tool_calls
boolean
default:"true"
Menentukan apakah memperbolehkan beberapa pemanggilan tool secara paralel.
​
top_p
number
Parameter nucleus sampling (0-1).
​
reasoning
object
Konfigurasi reasoning untuk model yang mendukung reasoning seperti varian keluarga GPT-5.
  • effort (string): Tingkat usaha reasoning (low, medium, high)

​
Respons

​
id
string
Identifier unik untuk respons.
​
object
string
Selalu response.
​
created
integer
Timestamp Unix saat respons dibuat.
​
output
array
Daftar item output yang dihasilkan oleh model.
​
usage
object
Statistik penggunaan token.
curl -X POST "https://api.tokenlab.sh/v1/responses" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "input": [
      {"type": "message", "role": "user", "content": "Hello!"}
    ],
    "max_output_tokens": 1000
  }'

{
  "id": "resp_abc123",
  "object": "response",
  "created": 1706000000,
  "model": "gpt-4o",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {"type": "text", "text": "Hello! How can I help you today?"}
      ]
    }
  ],
  "usage": {
    "input_tokens": 10,
    "output_tokens": 12,
    "total_tokens": 22
  }
}