Create Generation

Generate images, videos, audio, or 3D models by sending a request to the Artificial Studio API.

POST /api/run

bash

curl -X POST https://api.artificialstudio.ai/api/run \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_API_KEY" \
  -d '{
    "tool": "create-image",
    "input": {
      "prompt": "A serene Japanese garden with cherry blossoms"
    }
  }'

200

{
  "id": "507f1f77bcf86cd799439011",
  "status": "processing",
  "tool": "create-image",
  "createdAt": "2024-01-15T10:30:00.000Z"
}

Create a new generation by specifying a tool and input parameters. Returns immediately with a generation ID while processing happens asynchronously.

Headers

Name	Type	Required	Description
Authorization	string	Yes	Your API key
Content-Type	string	Yes	Must be application/json

Body

Parameter	Type	Required	Description
tool	string	Yes	Tool identifier (e.g., create-image, create-video). Use GET /api/tools to list available tools
input	object	Yes	Tool-specific parameters
input.model	string	No	Model to use. Defaults to the tool’s primary model
input.prompt	string	Varies	Text prompt for generation
webhook	string	No	HTTPS URL to receive completion notifications

The request body is validated strictly — unknown fields will be rejected with a 400 error.

Response Fields

Field	Type	Description
id	string	Unique generation identifier
status	string	Initial status (processing)
tool	string	Tool used for this generation
createdAt	string	ISO 8601 timestamp

bash

curl -X POST https://api.artificialstudio.ai/api/run \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_API_KEY" \
  -d '{
    "tool": "create-image",
    "input": {
      "prompt": "A serene Japanese garden with cherry blossoms"
    }
  }'

200

{
  "id": "507f1f77bcf86cd799439011",
  "status": "processing",
  "tool": "create-image",
  "createdAt": "2024-01-15T10:30:00.000Z"
}