DigenAI Skill#

Generate images from text prompts and videos from images via DigenAI API.

⚠️ First Time Users: Get Your Free API Key#

Video generation requires a free API key (starts with ak_).

How to Get Your API Key#

1. Visit: https://claw.digen.ai
2. Or join Discord: https://discord.gg/SRhbTt9hwp
3. Or contact Telegram: @digen_skill_bot

Your API key is used as:

text

Authorization: Bearer YOUR_API_KEY

Note: The API uses https://api.cowork.digen.ai as the base URL.

---

Quick Start#

python

from digen_ai_client import DigenAIClient

# Video generation — requires API Key (ak_xxx)
client = DigenAIClient(api_key="ak_xxxxxxxxxxxxxxxxxxxx")

---

Image Generation (Old API)#

Uses api.digen.ai with DIGEN_TOKEN + DIGEN_SESSION_ID

Available Models#

ModelDescriptiondefaultHigh quality model

Example#

python

from digen_ai_client import DigenAIClient

client = DigenAIClient(
    old_api_token="your_token",
    old_api_session="your_session"
)

result = client.generate_image_sync(
    prompt="futuristic cyberpunk city at night, neon lights, rainy streets, highly detailed, 8K",
    model="default",
    resolution="1:1"
)

if result["success"]:
    print(f"✅ Image: {result['images'][0]}")
else:
    print(f"❌ Error: {result.get('error')}")

---

Video Generation (New API)#

Uses new API with Bearer API Key

⚠️ Important: Use model="turbo"#

The video generation API requires model="turbo" parameter (not default).

Available Models#

ModelDescriptionMax DurationturboFast and high quality generation10s

Video Types#

• Image-to-Video: ✅ Works - requires image_url + prompt
• Text-to-Video: ⚠️ May not work with all API keys (depends on credits)

Example: Image-to-Video (Recommended)#

python

from digen_ai_client import DigenAIClient

client = DigenAIClient(api_key="ak_xxxxxxxxxxxxxxxxxxxx")

result = client.generate_video_sync(
    image_url="https://your-image.jpg",
    prompt="gentle camera pan left, neon lights twinkling",
    model="turbo",  # IMPORTANT: use "turbo", not "default"
    duration=5
)

if result["success"]:
    print(f"✅ Video: {result['video_url']}")
    print(f"   Thumbnail: {result['thumbnail_url']}")
else:
    print(f"❌ Error: {result.get('error')}")

Example: Text-to-Video (May Not Work)#

python

client = DigenAIClient(api_key="ak_xxxxxxxxxxxxxxxxxxxx")

result = client.generate_video_sync(
    prompt="A cute cat playing piano in a cozy room, soft lighting",
    model="turbo",
    duration=5
)

if result["success"]:
    print(f"✅ Video: {result['video_url']}")
else:
    print(f"❌ Error: {result.get('error')}")
    # Note: Text-to-Video may fail if your API key only has image-to-video credits

---

API Key Management (New API)#

Check API Key Info#

python

client = DigenAIClient(api_key="ak_xxx")
info = client.get_api_key_info()
print(info)
# {'success': True, 'data': {'api_key': 'ak_xxx', 'status': 1, 'created_at': '...'}}

Upload Image#

python

result = client.upload_image(file_path="/path/to/image.jpg")
if result["success"]:
    print(f"Image URL: {result['url']}")

---

Configuration#

Environment Variables#

VariableDescriptionDIGEN_TOKENOld API token for image generationDIGEN_SESSION_IDOld API session ID for image generationDIGEN_API_KEYNew API key (ak_xxx) for video generation

Setup#

bash

# Image generation (old API)
export DIGEN_TOKEN="your_token"
export DIGEN_SESSION_ID="your_session"

# Video generation (new API)
export DIGEN_API_KEY="ak_xxxxxxxxxxxxxxxxxxxx"

---

Error Handling#

No API Key Error (Video)#

text

❌ API Key Not Found!

Get your free API key:
- Visit: https://claw.digen.ai
- Or join Discord: https://discord.gg/SRhbTt9hwp

Error Codes (New API)#

HTTP CodeError CodeDescription400invalid_requestInvalid or missing parameters401invalid_api_keyInvalid or missing API key402insufficient_creditsNot enough credits404not_foundResource not found500internal_errorInternal server error

---

API Reference#

New API Endpoints (Video)#

MethodEndpointDescriptionGET``/b/v1/api-keyGet API key infoPOST``/b/v1/uploadUpload image filePOST``/b/v1/video/generateGenerate videoGET``/b/v1/video/{id}Get video status

Base URL: https://api.cowork.digen.ai

Old API Endpoints (Image)#

MethodEndpointDescriptionPOST``/v2/tools/text_to_imageGenerate imagePOST``/v6/video/get_task_v2Get image status

Base URL: https://api.digen.ai

---

Scripts#

• scripts/digen_ai_client.py - Python client with sync/async support
• scripts/batch_generate.py - Batch image generation utility
• assets/telegram-bot.py - Telegram bot for API key distribution
• assets/discord-bot.py - Discord bot for API key distribution

Tips#

• Video model: Always use model="turbo" (not default or seedance-2.0)
• Image-to-Video: Requires image_url parameter
• Text-to-Video: May not work with all API keys
• Video generation: poll every 5 seconds, timeout 300s
• Image generation: poll every 3 seconds, timeout 120s