Structured Outputs

from openai import OpenAI
from pydantic import BaseModel, Field
import os

client = OpenAI(
    base_url="https://api.neosantara.xyz/v1",
    api_key=os.environ["NEOSANTARA_API_KEY"]
)

class ResearchPaper(BaseModel):
    title: str = Field(description="Title of the paper")
    authors: list[str] = Field(description="List of authors")
    published_year: int = Field(description="Year published")
    summary: str = Field(description="Two-sentence summary")

completion = client.beta.chat.completions.parse(
    model="deepseek-v4.1-flash",
    messages=[
        {"role": "user", "content": "Extract data from: 'Attention Is All You Need' by Vaswani et al., published in 2017."}
    ],
    response_format=ResearchPaper
)

paper = completion.choices[0].message.parsed
print(f"Title: {paper.title}")
print(f"Year: {paper.published_year}")

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://api.neosantara.xyz/v1",
    api_key=os.environ["NEOSANTARA_API_KEY"]
)

response = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Return sample user details."}],
    response_format={
        "type": "json_schema",
        "json_schema": {
            "name": "user_profile",
            "strict": True,
            "schema": {
                "type": "object",
                "properties": {
                    "username": {"type": "string"},
                    "email": {"type": "string"},
                    "age": {"type": "integer"}
                },
                "required": ["username", "email", "age"],
                "additionalProperties": False
            }
        }
    }
)

print(response.choices[0].message.content)

curl -X POST https://api.neosantara.xyz/v1/chat/completions \
  -H "Authorization: Bearer $NEOSANTARA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "User sample"}],
    "response_format": {
      "type": "json_schema",
      "json_schema": {
        "name": "user",
        "strict": true,
        "schema": {
          "type": "object",
          "properties": {
            "name": {"type": "string"},
            "role": {"type": "string"}
          },
          "required": ["name", "role"],
          "additionalProperties": false
        }
      }
    }
  }'