how-tos

Panduan GPT-6.2 API: Permintaan Pertama di cURL & Python, Responses dan Chat Completions

Poyo.ai Team
8 min read
Share:

Panduan GPT-6.2 API: permintaan pertama di cURL dan Python

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"
FormatEndpointGunakan saat
ResponsesPOST https://api.poyo.ai/v1/responsesKode baru, function tool, input gambar, reasoning effort
Chat CompletionsPOST https://api.poyo.ai/v1/chat/completionsKode 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:

  1. Jangan kirim temperature atau top_p. OpenAI meminta keduanya dihilangkan, ditambah logprobs dan top_logprobs di Chat Completions serta top_logprobs di Responses. Skema PoYo masih mencantumkan temperature dan top_p untuk model yang lebih lama.
  2. Jangan atur reasoning effort ke none; API akan menolaknya.
  3. Taruh instruksi yang stabil di pesan developer di awal input. GPT-6.2 menambahkan instructions tingkat atas setelah input, 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.

SituasiPengaturanSumber
Integrasi barumediumOpenAI: "Mulailah dengan medium untuk integrasi baru."
Sebelumnya none atau minimallowCatatan migrasi GPT-6.2 dari OpenAI
Tugas panjang atau kompleksLevel yang lebih tinggiOpenAI: effort yang lebih tinggi "dapat membantunya bertahan sampai pemeriksaan akhir"
noneDitolakHalaman 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

HTTPPenyebabYang harus dilakukan
400Field tidak valid (validation_error, dengan detail)Perbaiki body; effort none atau field yang tidak terdokumentasi bisa berakhir di sini
401API key tidak ada atau tidak validPeriksa header Authorization
402Kredit tidak cukupIsi ulang sebelum mencoba lagi
404Model tidak dikenal (model_not_found)Periksa ID: gpt-6.2-sol, gpt-6.2-astra
429Terkena rate limitTunggu lalu coba lagi
500 / 502 / 503Error server atau upstreamCoba 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_KEY di sisi server; jangan pernah menyertakannya di kode browser atau mobile.
  • Hapus temperature dan top_p dari setiap jalur permintaan GPT-6.2, termasuk fungsi helper bersama.
  • Selalu atur max_output_tokens (atau max_tokens), dan sisakan ruang untuk token reasoning di dalam batas itu.
  • Catat status / finish_reason dan seluruh blok usage di samping ID permintaan Anda sendiri, agar jawaban yang terpotong dan lonjakan biaya terlihat.
  • Taruh konteks yang panjang dan stabil di pesan developer pertama dan pertanyaan yang berubah di akhir, agar prompt caching berpeluang bekerja.
  • Tetapkan ID model di konfigurasi, agar Anda bisa beralih antara gpt-6.2-sol dan gpt-6.2-astra tanpa 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.

Share: