Official OpenAI authentication کے ساتھ Astra API setup

Provider اور billing account سے آغاز کریں

اپنی OpenAI Platform key کے ساتھ OpenAI API سے gpt-6-astra استعمال کریں۔ Application کے لیے نیچے دیا گیا Responses example پہلے چلائیں۔ Local coding work کے لیے Codex CLI login اور model-selection commands استعمال کریں۔ دونوں paths آپ کے Platform account کو استعمال کرتے ہیں اور متعلقہ OpenAI rates کے مطابق API charges لیتے ہیں۔

Request چلانے سے پہلے confirm کریں کہ Platform project کا مالک کون ہے، key کو model access ہے یا نہیں، اور کون سے billing controls لاگو ہوتے ہیں۔ ChatGPT یا Codex میں model نظر آنے سے ہر API project کا access نہیں ملتا۔ اپنی run notes میں subscription login اور API-key login الگ رکھیں۔ بعد میں limit diagnose یا charges reconcile کرتے وقت یہ فرق ضروری ہوگا۔

Trusted environment میں key اور client تیار کریں

OpenAI dashboard میں API key بنائیں اور اسے private environment یا secret manager کے ذریعے OPENAI_API_KEY کے طور پر دیں۔ Official SDK اسی variable کو پڑھتا ہے۔ Key کو browser JavaScript، public repository، screenshot یا shared terminal transcript میں کبھی embed نہ کریں۔ Credentials سنبھالتے وقت shell tracing سے بھی بچیں۔

نیچے JavaScript example کے لیے project میں official openai package کے ساتھ npm install openai چلائیں۔ Installed version کو lockfile میں record کریں۔ واضح baseURL OpenAI منتخب کرتا ہے، کسی inherited custom endpoint کو نہیں۔ Existing agent configuration بھی دیکھیں: صرف اس لیے provider override اور کسی دوسری service کی credential compatible نہیں ہو جاتیں کہ دونوں Authorization header قبول کرتی ہیں۔

Responses request بھیجیں اور جواب پڑھیں

astra-example.mjs بنائیں، اس میں دیا گیا code رکھیں، پھر node astra-example.mjs چلائیں۔ Prompt ایک مختصر checklist مانگتا ہے تاکہ بڑے workflow سے جوڑنے سے پہلے returned answer inspect ہو سکے۔ پہلے request کے لیے automatic SDK retries بند ہیں، اس سے connection یا account errors diagnose کرنا آسان رہتا ہے۔

جب status completed ہو تو response.output_text میں SDK کا combined text output ہوتا ہے۔ اسے standard output پر print کریں تاکہ دوسرا program اسے پڑھ سکے یا file میں redirect کر سکے۔ Response metadata کو standard error پر بھیجیں تاکہ وہ answer سے الگ رہے۔ Incomplete response میں incomplete_details اور usage محفوظ کریں اور nonzero exit code واپس کریں۔

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: 'https://api.openai.com/v1',
  maxRetries: 0,
})
const response = await client.responses.create({
  model: 'gpt-6-astra',
  input: 'List three checks for a small code change.',
})
console.error(JSON.stringify({
  id: response.id,
  model: response.model,
  status: response.status,
  usage: response.usage,
  incomplete_details: response.incomplete_details,
}))
if (response.status === 'completed') {
  console.log(response.output_text)
} else {
  process.exitCode = 1
}

Local Codex کے لیے API-key authentication منتخب کریں

OpenAI local Codex work کے لیے API-key login document کرتا ہے۔ CLI میں credentials بدلنے سے پہلے codex login status دیکھیں۔ نیچے دیا گیا stdin command secret کو command argument میں paste کرنے سے بچاتا ہے۔ Login کے بعد active authentication method دوبارہ چیک کریں اور CLI model flag سے exact model منتخب کریں۔

آخری command Astra کو منتخب کر کے interactive session کھولتی ہے۔ اپنے project directory سے شروع کریں تاکہ agent درست files اور repository instructions پڑھ سکے۔ Existing provider overrides دیکھیں اور active account confirm کریں۔ API-key mode local work کے لیے ہے؛ Codex cloud کو ChatGPT authentication درکار ہے۔ Cloud task کو local جاری کرنا ہو تو پہلے working files اور باقی کام کا مختصر خلاصہ local project میں لے آئیں۔

codex login status
printenv OPENAI_API_KEY | codex login --with-api-key
codex login status
codex --model gpt-6-astra

Capabilities کو client path کے ساتھ match کریں

Astra Responses اور Chat Completions support کرتی ہے، مگر tool calling کے لیے Responses درکار ہے۔ ایسے agent کے لیے Responses استعمال کریں جو functions یا custom tools چلاتا ہے۔ Chat choices پڑھنے والا client صرف URL بدلنے سے Responses output parse نہیں کر سکتا، اور text-only smoke tool loop کو exercise نہیں کرتا۔

اپنی application کے چھوٹے example سے ایک وقت میں ایک capability شامل کریں۔ Tools کے لیے arguments validate کریں، function application میں چلائیں، اور matching call_id کے ساتھ Responses کے ذریعے result واپس کریں۔ Structured output کے لیے schema validate کریں اور incomplete responses handle کریں۔ Streaming میں text کے ساتھ completion اور cancellation events بھی process کریں۔ یہ features شامل کرتے وقت سادہ text request diagnostic path کے طور پر محفوظ رکھیں۔

Access، rate اور completion failures الگ diagnose کریں

Retry سے پہلے HTTP status اور structured error fields دیکھیں۔ OpenAI error guide invalid authentication، exhausted credits، enforced spend limits اور request-rate pressure میں فرق کرتی ہے۔ خاص طور پر 429 response اکیلا remedy منتخب کرنے کے لیے کافی نہیں؛ error.code اور متعلقہ account settings inspect کریں۔

Temporary rate pressure میں Retry-After موجود ہو تو اس کی پابندی کریں اور bounded retries استعمال کریں۔ Billing یا spend-limit failure کا حل account decision ہے، repeated requests نہیں۔ Responses result incomplete ہو تو یہ الگ حالت ہے اور tokens پہلے ہی استعمال ہو سکتے ہیں۔ Redacted error information اور usage محفوظ کریں؛ timeout یا missing receipt کو successful یا free attempt نہ بنائیں۔

Provider availability اور evidence: 5 ستمبر 2026

OpenAI نے GPT-6 Astra کا staged rollout announce کیا ہے اور اس کا model reference official API document کرتا ہے۔ یہاں کے examples انہی sources کی پیروی کرتے ہیں؛ اس guide کے لیے کوئی paid request یا Codex authentication switch نہیں چلایا گیا۔ 5 ستمبر 2026 کی public APIsRouter catalog check نے HTTP 200، success: true اور 34 models واپس کیے، مگر Astra یا GPT-6 entry نہیں تھی۔

OpenAI credentials صرف اوپر دکھائے گئے official endpoint کے ساتھ استعمال کریں۔ APIsRouter کی اپنی offerings کے لیے live catalog چیک کریں۔ بعد میں Astra کی listing آئے تب بھی اسے application میں استعمال کرنے سے پہلے exact model ID، price اور مطلوبہ client features verify کرنا ہوں گے۔

Response کو مفید local workflow سے جوڑیں

ایک concrete result والا local task چنیں، مثلاً function کی وضاحت اور test کی تجویز۔ Agent کو متعلقہ file path، expected behavior اور test command دیں۔ Code change کے بعد diff inspect کریں اور focused tests چلائیں۔ Original input اور returned answer ساتھ رکھیں تاکہ revisions آسانی سے compare ہوں۔

Application میں completed text کو review screen یا document pipeline میں بھیجیں۔ اگلا step machine-readable data مانگتا ہو تو structured output استعمال کریں اور store کرنے سے پہلے required fields validate کریں۔ Request identity اور usage کو task کے ساتھ محفوظ کریں اور bounded retry policy رکھیں۔ Basic input، response handling اور completion checks ساتھ کام کرنے لگیں تو workflow وسیع کریں۔

عمومی سوالات