Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Ručni response_format

Lekcija 5 od 12 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Više kontrole s response_format
  2. Tijek rada
  3. Cjeloviti primjer
  4. Razlike u odnosu na parse()
  5. Parsiranje bez Pydantica
  6. Kada odabrati response_format
  7. Rukovanje greškama
  8. Ključne točke

Više kontrole s response_format

Ručna metoda putem response_format daje ti punu kontrolu nad parsiranjem. Za razliku od parse(), koji vraća tipizirani objekt, ovaj pristup vraća JSON niz koji sam parsiraš – Pydantic model ovdje služi samo za definiranje sheme (model_json_schema()) i naknadnu validaciju. Odaberi ovu metodu kada ti treba fleksibilnost ili kada radiš u okruženju bez Pydantica.

Tijek rada

Kod response_format, proces se odvija u dva koraka:

  1. API vraća JSON kao niz u response.choices[0].message.content
  2. Taj niz parsiraš metodom po vlastitom izboru

Cjeloviti primjer

from openai import OpenAI
from pydantic import BaseModel

client = OpenAI(
    api_key="your-xai-key",
    base_url="https://api.x.ai/v1"
)

class MovieReview(BaseModel):
    title: str
    rating: float
    summary: str
    recommend: bool

response = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[{
        "role": "user",
        "content": "Review the movie Inception"
    }],
    response_format={
        "type": "json_schema",
        "json_schema": {
            "name": "movie_review",
            "schema": MovieReview.model_json_schema()
        }
    }
)

# Sadržaj je JSON niz
json_string = response.choices[0].message.content
print(type(json_string))  # <class 'str'>
print(json_string)
# {"title": "Inception", "rating": 9.2, "summary": "...", "recommend": true}

# Ručno parsiranje s Pydanticom
parsed = MovieReview.model_validate_json(json_string)
print(parsed.title)  # "Inception"

Razlike u odnosu na parse()

Aspektparse()response_format
Povratna vrijednost(Response, ParsedModel)Samo Response
ParsiranjeAutomatskoRučno
Pristup podacimaparsed.fieldjson.loads() ili model_validate_json()
FleksibilnostStandardnaMaksimalna
Rukovanje greškamaUgrađenoTvoja odgovornost

Parsiranje bez Pydantica

Ne moraš koristiti Pydantic za parsiranje rezultata. Standardni modul json također radi:

import json

response = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[{
        "role": "user",
        "content": "Analyze this text and extract entities"
    }],
    response_format={
        "type": "json_schema",
        "json_schema": {
            "name": "entities",
            "schema": {
                "type": "object",
                "properties": {
                    "people": {
                        "type": "array",
                        "items": { "type": "string" }
                    },
                    "places": {
                        "type": "array",
                        "items": { "type": "string" }
                    }
                }
            }
        }
    }
)

data = json.loads(response.choices[0].message.content)
print(data["people"])  # ["Marie Curie", "Pierre Curie"]
print(data["places"])      # ["Paris", "Warsaw"]

Kada odabrati response_format

response_format briljira kad god trebaš vidjeti ili pregledati JSON prije nego što postane objekt. Najčešći slučaj je bilježenje (logging): u proizvodnji, čuvanje sirovog JSON-a prije transformacije često je zahtjev za reviziju ili otklanjanje grešaka, a parse() ti ne daje tu točku presretanja. Sljedeće je pitanje sheme: ako je tvoj ugovor o sučelju sirova JSON shema – koju dijele drugi timovi, generira alat ili se verzionira neovisno o Python kodu – njezino izravno nametanje vjernije je od rekonstrukcije kao Pydantic modela. Konačno, ne svaki projekt djeluje unutar Pydantic ekosustava: ako tvoja validacija prolazi kroz drugi okvir ili kroz međukorak obrade specifičan za tvoj pipeline, response_format ti predaje JSON kakav jest i prepušta tebi kontrolu nad onim što slijedi.

Rukovanje greškama

Kod ručne metode, sam moraš rukovati greškama parsiranja:

import json

try:
    data = json.loads(response.choices[0].message.content)
except json.JSONDecodeError as e:
    print(f"Parsing error: {e}")

U praksi, ova greška nikada ne bi trebala nastati jer API jamči valjani JSON. No, defensivno rukovanje ostaje najbolja praksa u proizvodnji.

Ključne točke

  • response_format vraća JSON niz u response.choices[0].message.content
  • Parsiranje je tvoja odgovornost: json.loads(), model_validate_json() ili druga metoda
  • Možeš koristiti sirovu JSON shemu umjesto Pydantic modela
  • Veća fleksibilnost od parse(), ali zahtijeva više koda
  • Vraćeni JSON je zajamčeno valjan – greške parsiranja ne bi se trebale dogoditi