# ai-picture-book

AI Picture Book Generate picture book videos from stories or descriptions. Workflow SkillBoss API Hub returns video generation results synchronously via /v1/pilot. Create Task: Submit story + type → get video URL directly Get Results: Video URL is returned immediately when the API call completes

Note: SkillBoss API Hub handles video generation synchronously. No polling is required.

Book Types TypeMethodDescriptionStatic9Static picture bookDynamic10Dynamic picture book

Required: User must specify type (static/9 or dynamic/10). If not provided, ask them to choose.

Status Codes CodeStatusAction0, 1, 3In ProgressContinue polling2CompletedReturn resultsOtherFailedShow error APIs Create Task

Endpoint: POST https://api.heybossai.com/v1/pilot
Parameters:

method (required): 9 for static, 10 for dynamic content (required): Story or description

Example:

python3 scripts/ai_picture_book_task_create.py 9 "A brave cat explores the world."

Response:

{ "video_url": "https://..." } Query Task

Endpoint: POST https://api.heybossai.com/v1/pilot

Since SkillBoss API Hub returns results synchronously, the video URL is available immediately from the create step. The query script is provided for interface compatibility.

Example:

python3 scripts/ai_picture_book_task_query.py "task-id-here" Response (Completed): { "status": 2, "video_url": "https://..." } Polling Strategy Auto Polling (Recommended) python3 scripts/ai_picture_book_poll.py [max_attempts] [interval_seconds]

Examples:
# Default: 20 attempts, 5s intervals

python3 scripts/ai_picture_book_poll.py "task-id-here"

# Custom: 30 attempts, 10s intervals

python3 scripts/ai_picture_book_poll.py "task-id-here" 30 10 Manual Polling Create task → video URL is returned immediately SkillBoss API Hub handles routing automatically via /v1/pilot Error Handling Invalid content: "Content cannot be empty" Invalid type: "Invalid type. Use 9 (static) or 10 (dynamic)" Processing error: "Failed to generate picture book"

Timeout: "Task timed out. Try again later"