| name | phaseo-sdk-typescript |
| description | Implement Phaseo integrations with the official TypeScript and JavaScript SDK (`@phaseo/sdk`). Use when repositories already depend on `@phaseo/sdk`, need a new client setup, Responses API calls, async video jobs, preset usage, or request logging patterns for the SDK surface. |
Phaseo SDK TypeScript
Use this skill when the repository should call Phaseo through @phaseo/sdk instead of raw fetch or another compatibility client.
Outcome
Deliver a working TypeScript or JavaScript integration that:
- imports
Phaseo from @phaseo/sdk
- reads credentials from
PHASEO_API_KEY
- uses the smallest suitable SDK surface
- preserves request ids and model ids for debugging
Workflow
- Create one shared
Phaseo client.
- Prefer the Responses API for new text integrations.
- Reuse preset slugs instead of copying prompt and routing defaults into each caller.
- For async video, store the returned job id and poll until terminal.
- Validate with one small request on the exact surface you changed.
Canonical client setup
import { Phaseo } from "@phaseo/sdk";
export const gateway = new Phaseo({
apiKey: process.env.PHASEO_API_KEY!,
});
Preferred surface selection
- Text and multimodal generation:
generateResponse or streamResponse
- Chat-style compatibility only when the caller already expects chat-shape messages
- Images:
generateImage, generateImageEdit
- Audio:
generateSpeech, generateTranscription, generateTranslation
- Video:
generateVideo
- Discovery:
getModels, getHealth
Rules
- Prefer
generateResponse for net-new text features unless a caller already depends on chat-specific shape.
- Keep model ids configurable and discover current ids from
/v1/models or existing gateway discovery helpers.
- Keep API keys in env vars only.
- If the repository already has request logging, include request id, model id, and preset slug when available.
Validation
- one successful request on the changed endpoint
- one error-path check when auth or model lookup behavior changed
- confirm async jobs are tracked by returned id instead of assuming immediate completion
