AI Visuals in Every Workflow. One API. Zero Polling.

# Python SDK — Install and use CreativeAI natively
# pip install creativeai

from creativeai import CreativeAI

# Initialize (reads CREATIVEAI_API_KEY from env)
client = CreativeAI()

# Generate image — returns URL directly
image_url = client.generate_image("A sunset over mountains")
print(f"Image: {image_url}")

# Generate video — waits for completion
video_url = client.generate_video("A drone flying over the ocean")
print(f"Video: {video_url}")

# Generate voice narration
audio_url = client.generate_voice("Welcome to our product demo")
print(f"Audio: {audio_url}")

# Use in LangChain tools
from langchain.tools import Tool

image_tool = Tool(
    name="generate_image",
    func=client.generate_image,
    description="Generate an image. Input: text prompt. Output: image URL."
)

video_tool = Tool(
    name="generate_video",
    func=client.generate_video,
    description="Generate a short video. Input: text prompt. Output: video URL."
)

# Tools ready for LangChain, CrewAI, Claude Code agents

// AI Agent Tool Integration — TypeScript/JavaScript
// Works with Claude Code, AutoGPT, LangChain, CrewAI, and custom agents

import OpenAI from 'openai';

// Use CreativeAI as a tool in your agent workflow
const creativeai = new OpenAI({
  apiKey: process.env.CREATIVEAI_API_KEY,
  baseURL: 'https://api.creativeai.run/v1',
});

interface AgentContext {
  task_id: string;
  step: string;
  [key: string]: unknown;
}

async function generateFromAgentOutput(
  agentPrompt: string,
  context: AgentContext
): Promise<{ image_url: string; agent_context: AgentContext; revised_prompt?: string }> {
  const result = await creativeai.images.generate({
    model: 'gpt-image-1', // or dall-e-3, seedream-3.0
    prompt: agentPrompt,
    size: '1024x1024',
    n: 1,
  });

  return {
    image_url: result.data[0].url!,
    agent_context: context,
    revised_prompt: result.data[0].revised_prompt,
  };
}

// Example: Agent generates documentation screenshots
const screenshot = await generateFromAgentOutput(
  'API dashboard showing user analytics, dark mode',
  { task_id: 'docs-123', step: 'generate_screenshot' }
);

// Example: Agent creates visual explanations
const diagram = await generateFromAgentOutput(
  'System architecture diagram: microservices with API gateway',
  { task_id: 'arch-456', step: 'create_diagram' }
);

// Async video for long-running agent tasks
async function submitVideoTask(agentPrompt: string, webhookUrl: string): Promise<string> {
  const resp = await fetch('https://api.creativeai.run/v1/video/generations', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.CREATIVEAI_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'auto', // Auto-select best available model
      prompt: agentPrompt,
      webhook_url: webhookUrl, // Agent receives callback
    }),
  });
  const data = await resp.json();
  return data.id; // Poll or wait for webhook
}

// Poll for async job completion
async function pollForCompletion(jobId: string): Promise<string> {
  while (true) {
    const resp = await fetch(`https://api.creativeai.run/v1/video/generations/${jobId}`, {
      headers: { Authorization: `Bearer ${process.env.CREATIVEAI_API_KEY}` },
    });
    const status = await resp.json();
    if (status.status === 'completed') return status.output_url;
    if (status.status === 'failed') throw new Error(status.error?.message || 'Video failed');
    await new Promise((r) => setTimeout(r, 10000)); // Poll every 10s
  }
}