LLM APIs - lesson 4 | HackIndia Skills

LLM APIs - lesson 4 | HackIndia Skills | HackIndia

Example

Server route example

This example uses the official server-side JavaScript SDK. Keep your API key in OPENAI_API_KEY, not in browser code.

The model name shown is one documented as supporting Structured Outputs. If your project uses another model, check that it supports Structured Outputs before shipping.

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY
});

export async function POST(req) {
  const { eventText } = await req.json();

  const response = await client.responses.create({
    model: "gpt-4o-mini",
    instructions: "Extract campus event details. Return only data that fits the schema. If a value is not present, use null.",
    input: eventText,
    text: {
      format: {
        type: "json_schema",
        name: "campus_event",
        strict: true,
        schema: {
          type: "object",
          additionalProperties: false,
          properties: {
            title: { type: "string" },
            date_text: { type: ["string", "null"] },
            venue: { type: ["string", "null"] },
            fee_rupees: { type: ["number", "null"] },
            tags: {
              type: "array",
              items: { type: "string" }
            }
          },
          required: ["title", "date_text", "venue", "fee_rupees", "tags"]
        }
      }
    }
  });

  const data = JSON.parse(response.output_text);

  return Response.json({ event: data });
}

Return JSON your app can use

One idea

Use this for

Design the shape

Server route example

Common mistake

Check AI output

Do this now

Quick check