
Panduan GPT-6.2 API ini membawa Anda dari API key hingga permintaan yang berjalan untuk gpt-6.2-sol atau gpt-6.2-astra di cURL dan OpenAI SDK Python, pada endpoint Responses maupun Chat Completions. Setiap body permintaan mengikuti skema yang dipublikasikan PoYo dan catatan migrasi GPT-6.2 dari OpenAI per 18 November 2026. Anda bisa menguji prompt terlebih dahulu di halaman model GPT-6.2 Sol atau halaman model GPT-6.2 Astra.
Baru mengenal model ini? Ikhtisar GPT-6.2 API membahas batas dan posisinya.
Sebelum mulai
Buat kunci di dashboard PoYo dan simpan di server Anda:
export POYO_API_KEY="your-poyo-key"
| Format | Endpoint | Gunakan saat |
|---|---|---|
| Responses | POST https://api.poyo.ai/v1/responses | Kode baru, function tool, input gambar, reasoning effort |
| Chat Completions | POST https://api.poyo.ai/v1/chat/completions | Kode Chat Completions yang sudah ada, pesan teks saja, tanpa tool |
Setiap permintaan mengirim Authorization: Bearer $POYO_API_KEY. Contoh-contoh di sini memakai gpt-6.2-sol; ganti dengan gpt-6.2-astra untuk Astra. Bentuk permintaannya identik.
Tiga aturan dari panduan GPT-6.2 OpenAI berlaku untuk setiap contoh di bawah:
- Jangan kirim
temperatureatautop_p. OpenAI meminta keduanya dihilangkan, ditambahlogprobsdantop_logprobsdi Chat Completions sertatop_logprobsdi Responses. Skema PoYo masih mencantumkantemperaturedantop_puntuk model yang lebih lama. - Jangan atur reasoning effort ke
none; API akan menolaknya. - Taruh instruksi yang stabil di pesan
developerdi awalinput. GPT-6.2 menambahkaninstructionstingkat atas setelahinput, sehingga instruksi itu keluar dari prefix yang bisa di-cache.
Permintaan GPT-6.2 API pertama dengan cURL
curl https://api.poyo.ai/v1/responses \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.2-sol",
"input": [
{"role": "developer", "content": "You are a code reviewer. Be specific and cite line numbers."},
{"role": "user", "content": "Review this function for race conditions: ..."}
],
"reasoning": {"effort": "medium"},
"max_output_tokens": 8000,
"store": false
}'
model dan input wajib diisi. input berupa string biasa atau array item dengan role (developer, system, user, assistant) dan content. Field terdokumentasi lain yang dipakai di panduan ini: reasoning, max_output_tokens, stream, store, tools, tool_choice, previous_response_id, dan metadata.
Responsnya berupa objek Responses yang dikembalikan langsung. Teks ada di blok output[].content[] dengan type: "output_text"; status panggilan ada di status; dan jumlah token ada di usage.input_tokens, usage.output_tokens, dan usage.total_tokens.
Python dengan OpenAI SDK
Arahkan SDK ke PoYo:
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.poyo.ai/v1", api_key=os.environ["POYO_API_KEY"])
resp = client.responses.create(
model="gpt-6.2-sol",
input=[
{"role": "developer", "content": "You are a senior backend engineer."},
{"role": "user", "content": "Write a migration plan from Celery 4 to Celery 5."},
],
reasoning={"effort": "medium"},
max_output_tokens=8000,
)
print(resp.output_text)
print(resp.status, resp.usage)
resp.output_text adalah helper SDK yang menggabungkan semua blok output_text. Catat resp.usage di setiap panggilan; bagian biaya di bawah membacanya.
Chat Completions untuk kode yang sudah ada
Jika kode Anda sudah memakai chat.completions.create, ganti modelnya dan hapus field sampling:
resp = client.chat.completions.create(
model="gpt-6.2-sol",
messages=[
{"role": "system", "content": "You are a senior backend engineer."},
{"role": "user", "content": "Explain the CAP theorem with one example per trade-off."},
],
max_tokens=4000,
)
print(resp.choices[0].message.content, resp.choices[0].finish_reason)
Permintaan yang sama di cURL:
curl https://api.poyo.ai/v1/chat/completions \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.2-sol",
"messages": [{"role": "user", "content": "Explain vector databases in one sentence."}],
"max_tokens": 1000
}'
Skema Chat Completions PoYo mendokumentasikan model, messages (content berupa string; role system, user, assistant), max_tokens, stream, stop, n, dan field penalty. Skema itu tidak mendokumentasikan tools, dan OpenAI menyatakan bahwa tool calling GPT-6.2 memerlukan Responses, jadi agen sebaiknya memakai /v1/responses.
Mengatur reasoning effort lewat GPT-6.2 API
OpenAI menamai field ini reasoning.effort di Responses dan reasoning_effort di Chat Completions. Referensi Responses PoYo mendokumentasikan reasoning (contoh {"effort": "medium"}); referensi Chat Completions-nya belum mencantumkan reasoning_effort, jadi panduan ini hanya mengatur effort di Responses.
| Situasi | Pengaturan | Sumber |
|---|---|---|
| Integrasi baru | medium | OpenAI: "Mulailah dengan medium untuk integrasi baru." |
Sebelumnya none atau minimal | low | Catatan migrasi GPT-6.2 dari OpenAI |
| Tugas panjang atau kompleks | Level yang lebih tinggi | OpenAI: effort yang lebih tinggi "dapat membantunya bertahan sampai pemeriksaan akhir" |
none | Ditolak | Halaman model OpenAI |
Panduan reasoning OpenAI mencantumkan low, medium, high, xhigh, dan max di antara nilai yang mungkin, tetapi menyebutkan bahwa nilainya bergantung pada model. Halaman model GPT-6.2 tidak mencantumkan nilai yang diterima, jadi kirim satu permintaan uji sebelum Anda menetapkan level di atas medium secara permanen di kode. Token reasoning ditagih sebagai output dan dihitung terhadap max_output_tokens; OpenAI melaporkannya di usage.output_tokens_details.reasoning_tokens.
Streaming respons GPT-6.2 API
Dengan "stream": true, PoYo mengembalikan text/event-stream. Setiap baris data: adalah JSON yang type-nya menamai event; teks datang sebagai response.output_text.delta, dan response.completed membawa objek akhir beserta usage. PoYo tidak mengirim baris event: terpisah, dan stream diakhiri dengan data: [DONE].
stream = client.responses.create(
model="gpt-6.2-sol",
input="Write a 100-word product introduction for a log search tool.",
reasoning={"effort": "low"},
max_output_tokens=2000,
stream=True,
store=False,
)
usage = None
for event in stream:
if event.type == "response.output_text.delta":
print(event.delta, end="", flush=True)
elif event.type == "response.completed":
usage = event.response.usage
elif event.type == "response.failed":
raise RuntimeError(event.response)
print("\n", usage)
Di Chat Completions, stream=True mengembalikan event chat.completion.chunk; teks ada di choices[0].delta.content dan chunk terakhir membawa usage.
Input gambar
GPT-6.2 menerima gambar bersama teks. Di PoYo, kirim gambar ke Responses sebagai blok input_image dengan URL publik atau Data URI lengkap (data:image/png;base64,...). Dokumentasi PoYo menyarankan teks diletakkan sebelum gambar:
{
"model": "gpt-6.2-sol",
"input": [
{
"role": "user",
"content": [
{"type": "input_text", "text": "List every service in this architecture diagram that writes to the database."},
{"type": "input_image", "image_url": "https://example.com/diagram.png"}
]
}
],
"max_output_tokens": 3000
}
Membaca usage dan menghitung biaya permintaan
Harga PoYo per 1M token: Sol $1.60 input, $8 output, $0.08 baca cache, $2 tulis cache; Astra $6.40, $32, $0.32, $8 (1 kredit = $0.005).
Panduan caching OpenAI melaporkan baca cache yang ditagih di usage.input_tokens_details.cached_tokens dan tulis cache di usage.input_tokens_details.cache_write_tokens. Skema PoYo menyertakan input_tokens_details dan output_tokens_details tanpa mencantumkan key-nya, jadi bacalah secara defensif:
PRICES = { # PoYo USD per 1M tokens: input, output, cache read, cache write
"gpt-6.2-sol": (1.60, 8.00, 0.08, 2.00),
"gpt-6.2-astra": (6.40, 32.00, 0.32, 8.00),
}
def estimate_cost_usd(model: str, usage) -> float:
p_in, p_out, p_read, p_write = PRICES[model]
details = getattr(usage, "input_tokens_details", None)
cached = getattr(details, "cached_tokens", 0) or 0
written = getattr(details, "cache_write_tokens", 0) or 0
fresh = usage.input_tokens - cached - written
return (fresh * p_in + cached * p_read + written * p_write
+ usage.output_tokens * p_out) / 1_000_000
Anggap ini sebagai estimasi dan cocokkan dengan log pemakaian PoYo Anda. Semua harga di sini adalah tarif konteks pendek. OpenAI menagih lebih mahal di atas 272K token input, jadi periksa halaman model untuk permintaan sebesar itu. Contoh perhitungan ada di Harga GPT-6.2 API.
Error yang perlu ditangani
| HTTP | Penyebab | Yang harus dilakukan |
|---|---|---|
| 400 | Field tidak valid (validation_error, dengan detail) | Perbaiki body; effort none atau field yang tidak terdokumentasi bisa berakhir di sini |
| 401 | API key tidak ada atau tidak valid | Periksa header Authorization |
| 402 | Kredit tidak cukup | Isi ulang sebelum mencoba lagi |
| 404 | Model tidak dikenal (model_not_found) | Periksa ID: gpt-6.2-sol, gpt-6.2-astra |
| 429 | Terkena rate limit | Tunggu lalu coba lagi |
| 500 / 502 / 503 | Error server atau upstream | Coba lagi dengan exponential backoff |
Dokumentasi PoYo menyebutkan bahwa endpoint LLM saat ini tidak dibatasi rate limit, tetapi tetap tangani 429. Dengan OpenAI SDK, tangkap openai.APIStatusError dan percabangkan berdasarkan status_code. Ulangi hanya 5xx dan 429; error 400 akan gagal lagi sampai body-nya diubah. Body lengkapnya ada di kode error PoYo.
Checklist sebelum rilis
- Simpan
POYO_API_KEYdi sisi server; jangan pernah menyertakannya di kode browser atau mobile. - Hapus
temperaturedantop_pdari setiap jalur permintaan GPT-6.2, termasuk fungsi helper bersama. - Selalu atur
max_output_tokens(ataumax_tokens), dan sisakan ruang untuk token reasoning di dalam batas itu. - Catat
status/finish_reasondan seluruh blokusagedi samping ID permintaan Anda sendiri, agar jawaban yang terpotong dan lonjakan biaya terlihat. - Taruh konteks yang panjang dan stabil di pesan
developerpertama dan pertanyaan yang berubah di akhir, agar prompt caching berpeluang bekerja. - Tetapkan ID model di konfigurasi, agar Anda bisa beralih antara
gpt-6.2-soldangpt-6.2-astratanpa deploy.
Untuk tool, streaming tool call, dan caching di sesi agen yang panjang, lanjutkan ke GPT-6.2 API untuk agen coding.
Pertanyaan yang sering diajukan
Bagaimana cara memanggil GPT-6.2 API di Python?
Gunakan OpenAI SDK dengan base_url="https://api.poyo.ai/v1", kunci PoYo Anda, dan model="gpt-6.2-sol" atau "gpt-6.2-astra" di client.responses.create.
Apakah GPT-6.2 API mendukung streaming?
Ya, di kedua endpoint. Atur stream: true; Responses mengirim event bertipe seperti response.output_text.delta dan Chat Completions mengirim event chat.completion.chunk. Keduanya diakhiri dengan data: [DONE].
Bagaimana cara mengatur reasoning effort GPT-6.2 API?
Kirim "reasoning": {"effort": "medium"} di /v1/responses. OpenAI menyarankan mulai dengan medium dan menolak none.
Mengapa permintaan GPT-6.2 API saya gagal saat memakai temperature?
OpenAI meminta temperature dan top_p dihilangkan untuk GPT-6.2. Hapus keduanya dan kendalikan panjang output dengan max_output_tokens atau max_tokens.
Bagaimana cara mengirim gambar ke GPT-6.2 API?
Gunakan /v1/responses dengan blok input_image (URL atau Data URI) setelah blok input_text. Skema Chat Completions PoYo hanya mendokumentasikan konten berupa string.