Skip to main content
Runflow ships an official JavaScript surface as runflow-js. Three packages, one for each integration shape. For other languages, generate a client from the public OpenAPI spec.

​
JavaScript packages

PackageWhat it doesWhere it runs
@runflow-io/sdkTyped HTTP client and tool DSL for the API.Node, Bun, Deno, browsers, edge workers.
@runflow-io/proxyWeb Standards handler that injects your API key for browser calls.Any server framework (Next.js, Hono, Workers, Express).
@runflow-io/studioDrop the Studio UI into a <div>.Browser, via npm.
All three packages target the same api.runflow.io REST surface documented in the API reference. They are MIT-licensed and published from github.com/runflow-io/runflow-js.
Browsing without a key. GET /v1/public/models is an unauthenticated endpoint that returns the same model catalog the docs render from. Useful for client-side model pickers, IDE plugins, and discovery flows that should not ship an API key. Run dispatch + everything else still requires Authorization: Bearer $RUNFLOW_API_KEY.
These packages are pre-1.0 (0.0.x). Patch releases may change types or runtime behavior. Pin exact versions in production until 1.0.

​
Install

bun add @runflow-io/sdk
# or: npm install @runflow-io/sdk
# or: pnpm add @runflow-io/sdk

​
One call, server-side

import { Runflow } from "@runflow-io/sdk";

const rf = new Runflow({ apiKey: process.env.RUNFLOW_API_KEY });
const dispatched = await rf.models.run("runflow/background-removal", {
  input: { image_url: "https://example.com/photo.jpg" },
});
// dispatched.id is the run id; same shape as the REST response.
const final = await rf.runs.wait(dispatched.id);
console.log(final.output);
Walk through every option in the JavaScript SDK guide.

​
Codegen for other languages

The public OpenAPI 3.1 spec is the same one that generates this site’s API reference: 
https://docs.runflow.io/api/openapi.public.json

​
TypeScript types

npx openapi-typescript https://docs.runflow.io/api/openapi.public.json \
  -o src/runflow-types.ts

​
Python client

pip install openapi-python-client
openapi-python-client generate --url https://docs.runflow.io/api/openapi.public.json

​
Go client

go install github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen@latest
oapi-codegen -package runflow https://docs.runflow.io/api/openapi.public.json > runflow.go

​
Hand-rolled HTTP

For most integrations a raw fetch or requests call is enough. Both snippets bound the network wait so a stuck connection never hangs the caller. 
import os, requests

RUNFLOW_API_KEY = os.environ["RUNFLOW_API_KEY"]
REQUEST_TIMEOUT = 30  # seconds

def runflow_post(path, body):
    r = requests.post(
        f"https://api.runflow.io{path}",
        headers={"Authorization": f"Bearer {RUNFLOW_API_KEY}"},
        json=body,
        timeout=REQUEST_TIMEOUT,
    )
    r.raise_for_status()
    return r.json()

JavaScript SDK

Server-side, browser, and the tool DSL.

Embed the Studio

Drop the Studio into your site in three lines.

OpenAPI

Spec details and codegen recipes.

Authentication

Bearer header.