API Quickstart - BizyAir-Docs

BizyAir Model Service exposes every AI model (or AI app, workflow) as an HTTPS POST endpoint. All tasks are initiated through a unified task creation interface.

Core Concepts

Concept	Description
web_app_id	Unique numeric ID of the AI app or workflow
input_values	Workflow input parameters, key format: `NodeID:NodeName.FieldName`
request_id	Unique ID assigned per task for querying/canceling
object_url	Temporary hosting URL for result files
status	Task status: Queuing / Preparing / Running / Success / Failed / Canceled
API Key	Account credential from User Center
Balance	Prepaid credits, deducted by actual consumption

Three-Minute Quickstart

# 1. Set API Key (from User Center → API Keys)
export BIZYAIR_API_KEY="your-api-key-here"

# 2. Call AI app synchronously
curl -X POST "https://api.bizyair.ai/v1/webapp/task/openapi/create" \
  -H "Authorization: Bearer $BIZYAIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "web_app_id": 38214,
    "input_values": {
      "84:CLIPTextEncode.text": "a futuristic cityscape at sunset",
      "88:KSampler.seed": 354884000907176,
      "81:EmptySD3LatentImage.width": 1280,
      "81:EmptySD3LatentImage.height": 1280
    }
  }'