Structured Outputs: JSON Schema ile Garantili Format

import OpenAI from "openai";
import { z } from "zod";
import { zodResponseFormat } from "openai/helpers/zod";
 
const openai = new OpenAI();
 
// 1. Schema tanımla (Zod ile, hem TS tipini hem JSON schema'yı bir kerede)
const ArticleAnalysis = z.object({
  title: z.string(),
  summary: z.string().max(200),
  topics: z.array(z.string()).min(1).max(10),
  sentiment: z.enum(["pozitif", "negatif", "nötr"]),
  reading_time_min: z.number().int().min(1),
  key_quotes: z.array(z.object({
    text: z.string(),
    speaker: z.string().nullable(),
  })),
});
 
// 2. API çağrısı — beta.chat.completions.parse kullan
const result = await openai.beta.chat.completions.parse({
  model: "gpt-5",
  messages: [
    { role: "system", content: "Sen makaleleri analiz eden bir asistansın." },
    { role: "user", content: "Şu makaleyi analiz et: [...]" },
  ],
  response_format: zodResponseFormat(ArticleAnalysis, "analysis"),
});
 
// 3. Tip-güvenli, garanti schema'lı erişim
const analysis = result.choices[0].message.parsed;
// analysis: ArticleAnalysis (TypeScript bilir!)
console.log(analysis.title);
console.log(analysis.topics.join(", "));