🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Tomoviee Text to Music
πŸ¦€ ClawHub

Tomoviee Text to Music

by @wondershare-boop

Generate background music from text prompts using Tomoviee Text-to-Music API (`tm_text2music`) through Wondershare OpenAPI gateway (`https://openapi.wondersh...

Versionv1.0.2
Downloads764
#clawhub
TERMINAL
clawhub install tomoviee-text-to-music

πŸ“– About This Skill

name: tomoviee-text-to-music description: Generate background music from text prompts using Tomoviee Text-to-Music API (tm_text2music) through Wondershare OpenAPI gateway (https://openapi.wondershare.cc). Use when users request text-to-music generation with duration and quantity control.

Tomoviee AI Text-to-Music

Overview

Generate background music from text prompts.

  • API capability: tm_text2music
  • Task creation endpoint: https://openapi.wondershare.cc/v1/open/capacity/application/tm_text2music
  • Result endpoint: https://openapi.wondershare.cc/v1/open/pub/task

    • Provider and Endpoint Provenance

    Use this mapping to verify provider identity and runtime endpoints:

  • Vendor portals: https://www.tomoviee.ai and https://www.tomoviee.cn
  • API gateway host used by this skill: https://openapi.wondershare.cc
  • This skill sends runtime API calls only to openapi.wondershare.cc

    • Credential Handling

  • app_key and app_secret are only used to construct Authorization: Basic .
  • Credentials are kept in process memory only and are not written to disk by this skill.
  • Do not commit credentials into SKILL.md, scripts, or repository files.

    • Quick Start

    Install dependencies

    pip install -r requirements.txt

    Authentication helper

    python scripts/generate_auth_token.py YOUR_APP_KEY YOUR_APP_SECRET

    Python Client

    from scripts.tomoviee_text2music_client import TomovieeText2MusicClient
    client = TomovieeText2MusicClient("app_key", "app_secret")

    API Usage

    Basic Example

    task_id = client.text_to_music(
    prompt="Upbeat tech music, modern and energetic electronic pop",
    duration=30,
    qty=1,
    disable_translate=False,
)
    result = client.poll_until_complete(task_id)
import json
audio_url = json.loads(result["result"])["audio_path"][0]
print(audio_url)

    Parameters

  • prompt (required): Prompt text. Supports up to 77 tokens; extra content is truncated.
  • duration (required): Target music duration in seconds, range 0-95.
  • qty (required): Number of generated music outputs, range 1-4.
  • disable_translate (optional): Whether to disable translation.
  • callback (optional): Callback URL.
  • params (optional): Transparent callback parameter.

    • Async Workflow

    1. Create task and get task_id 2. Poll with poll_until_complete(task_id) 3. Parse output URL from result

    Status codes:

  • 1 queued
  • 2 processing
  • 3 success
  • 4 failed
  • 5 cancelled
  • 6 timeout

    • Resources

  • scripts/tomoviee_text2music_client.py - main API client
  • scripts/tomoviee_text_to_music_client.py - compatibility import shim
  • scripts/generate_auth_token.py - auth token helper
  • references/audio_apis.md - API reference and parameter constraints
  • references/prompt_guide.md - prompt writing guidance

    • External Resources

  • Developer portal (global): https://www.tomoviee.ai/developers.html
  • API docs (global): https://www.tomoviee.ai/doc/
  • Developer portal (mainland): https://www.tomoviee.cn/developers.html
  • API docs (mainland): https://www.tomoviee.cn/doc/
  • API gateway host used by this package: https://openapi.wondershare.cc

    • πŸ’‘ Examples

    Install dependencies

    pip install -r requirements.txt

    Authentication helper

    python scripts/generate_auth_token.py YOUR_APP_KEY YOUR_APP_SECRET

    Python Client

    from scripts.tomoviee_text2music_client import TomovieeText2MusicClient
    client = TomovieeText2MusicClient("app_key", "app_secret")