openai

name	openai
title	OpenAI API
category	AI APIs
description	Use to build with OpenAI's Responses API for text, images, files, structured output, streaming, tools, and vector embeddings.
tags	["openai","responses-api","structured-output","streaming","embeddings"]
official_docs	https://developers.openai.com/api/docs
sources	["https://developers.openai.com/api/docs/quickstart","https://developers.openai.com/api/docs/guides/structured-outputs","https://developers.openai.com/api/docs/guides/streaming-responses","https://developers.openai.com/api/docs/guides/embeddings"]
last_verified	2026-08-10T00:00:00.000Z

OpenAI API - Skillship

Generate and analyze text, images, and files through the Responses API, with schema-safe output, typed streams, callable tools, and embeddings for semantic search.

🧭 When to use this skill

• Use when: adding generation, extraction, classification, vision, document analysis, or tool-calling workflows.
• Use when: you need structured output or embeddings for search and recommendations.
• Don't use for: deterministic business rules that ordinary code can implement more cheaply and reliably.

⚡ Quickstart

1. Install

npm install openai

2. Configure (server only)

OPENAI_API_KEY=sk-...
OPENAI_MODEL=gpt-5.6

The SDK reads OPENAI_API_KEY automatically.

3. Call the Responses API

import "server-only";
import OpenAI from "openai";

const openai = new OpenAI();

const response = await openai.responses.create({
  model: process.env.OPENAI_MODEL ?? "gpt-5.6",
  instructions: "Answer accurately and say when you do not know.",
  input: "Explain vector databases in two sentences.",
});

console.log(response.output_text);

🧩 Common recipes

Recipe: Structured output with Zod

npm install zod

import OpenAI from "openai";
 { zodTextFormat }  ;
 { z }  ;

  = z.({
  : z.(),
  : z.(),
  : z.(z.()),
});

 response =  openai..({
  : process.. ?? ,
  : ,
  : { : (, ) },
});

 (!response.)   ();
.(response.);