The RunAPI Core JavaScript SDK provides shared authentication, HTTP, retry, error, and polling primitives for RunAPI model SDK packages. Install @runapi.ai/core only when you are building SDK infrastructure or shared tooling; application code should normally install a concrete model package such as @runapi.ai/suno.

Install

npm install @runapi.ai/core

Notes

Use the core package for ClientOptions, common error classes, request helpers, and task polling behavior that model SDKs share. Public SDK docs live at https://runapi.ai/docs#runapi-sdks and the model catalog lives at https://runapi.ai/models.

Request identifiers

RunAPI accepts an optional X-Client-Request-Id header on public API calls. Use printable ASCII values up to 512 characters. Accepted values are echoed in the response and stored with the RunAPI task for support and reconciliation.

await client.textToImage.create(
  { prompt: 'A sunset over the ocean' },
  { headers: { 'X-Client-Request-Id': 'order-123' } }
);

Public API responses expose X-RunAPI-Task-Id when a RunAPI task exists. High-level model SDK methods return parsed response bodies; use a custom transport or direct HTTP request when your integration needs response headers.

File Upload

import { NanoBananaClient } from '@runapi.ai/nano-banana';

const client = new NanoBananaClient({ apiKey: process.env.RUNAPI_API_KEY });

const upload = await client.files.create({ source: { type: 'url', url: 'https://cdn.runapi.ai/public/samples/image.jpg' } });
console.log(upload.url);