{
  "schemaVersion": "1.0",
  "item": {
    "slug": "audio-upload-aioz-stream",
    "name": "Upload audio to AIOZ Stream",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/vinhbui3004/audio-upload-aioz-stream",
    "canonicalUrl": "https://clawhub.ai/vinhbui3004/audio-upload-aioz-stream",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/audio-upload-aioz-stream",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=audio-upload-aioz-stream",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "references/api_reference.md",
      "SKILL.md",
      "_meta.json",
      "scripts/create_audio_default.sh",
      "scripts/get_audio_detail.sh",
      "scripts/upload_audio_file.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/audio-upload-aioz-stream"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/audio-upload-aioz-stream",
    "agentPageUrl": "https://openagent3.xyz/skills/audio-upload-aioz-stream/agent",
    "manifestUrl": "https://openagent3.xyz/skills/audio-upload-aioz-stream/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/audio-upload-aioz-stream/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "AIOZ Stream Audio Upload",
        "body": "Upload audio to AIOZ Stream API quickly with API key authentication. The full upload flow requires 3 API calls: Create → Upload Part → Complete."
      },
      {
        "title": "When to use this skill",
        "body": "User wants to upload or create an audio on AIOZ Stream\nUser mentions \"upload audio\", \"create audio\", \"aioz stream audio\"\nUser wants to get an HLS streaming link for their audio"
      },
      {
        "title": "Authentication",
        "body": "This skill uses API key authentication. The user must provide:\n\nstream-public-key: their AIOZ Stream public key\nstream-secret-key: their AIOZ Stream secret key\n\nAsk the user for these keys if not provided. They will be sent as HTTP headers on ALL API calls."
      },
      {
        "title": "Usage Options",
        "body": "When the user wants to upload audio, ask them to choose:"
      },
      {
        "title": "Option 1: Default Upload (Quick)",
        "body": "Creates an audio object with minimal config — just a title. Then uploads the file.\n\nExample user prompt:\n\n\"Upload audio file /path/to/audio.mp3 with title My Podcast\""
      },
      {
        "title": "Option 2: Custom Upload (Advanced)",
        "body": "Creates an audio object with full encoding configuration including quality presets, bitrate, sample rate, tags, metadata, etc. Then uploads the file.\n\nExample user prompt:\n\n\"Upload audio with custom config: title My Podcast, highest quality HLS, 320kbps, 48000Hz, tags podcast,tech\""
      },
      {
        "title": "Step 1: Create Audio Object",
        "body": "Default:\n\ncurl -s -X POST 'https://api-w3stream.attoaioz.cyou/api/videos/create' \\\n  -H 'stream-public-key: PUBLIC_KEY' \\\n  -H 'stream-secret-key: SECRET_KEY' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"title\": \"AUDIO_TITLE\",\n    \"type\": \"audio\"\n  }'\n\nCustom (with encoding config):\n\ncurl -s -X POST 'https://api-w3stream.attoaioz.cyou/api/videos/create' \\\n  -H 'stream-public-key: PUBLIC_KEY' \\\n  -H 'stream-secret-key: SECRET_KEY' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"title\": \"AUDIO_TITLE\",\n    \"type\": \"audio\",\n    \"description\": \"DESCRIPTION\",\n    \"is_public\": true,\n    \"tags\": [\"tag1\", \"tag2\"],\n    \"metadata\": [\n      {\"key\": \"KEY\", \"value\": \"VALUE\"}\n    ],\n    \"qualities\": [\n      {\n        \"resolution\": \"highest\",\n        \"type\": \"hls\",\n        \"container_type\": \"mpegts\",\n        \"audio_config\": {\n          \"codec\": \"aac\",\n          \"bitrate\": 320000,\n          \"channels\": \"2\",\n          \"sample_rate\": 48000,\n          \"language\": \"en\",\n          \"index\": 0\n        }\n      },\n      {\n        \"resolution\": \"standard\",\n        \"type\": \"hls\",\n        \"container_type\": \"mpegts\",\n        \"audio_config\": {\n          \"codec\": \"aac\",\n          \"bitrate\": 128000,\n          \"channels\": \"2\",\n          \"sample_rate\": 44100,\n          \"language\": \"en\",\n          \"index\": 0\n        }\n      }\n    ]\n  }'\n\nResponse: Extract data.id — this is the AUDIO_ID used in the next steps."
      },
      {
        "title": "Step 2: Upload File Part",
        "body": "Upload the actual audio file binary to the created audio object.\n\nFirst, get the file size and compute the MD5 hash:\n\n# Get file size (cross-platform compatible)\nFILE_SIZE=$(stat -f%z /path/to/audio.mp3 2>/dev/null || stat -c%s /path/to/audio.mp3)\nEND_POS=$((FILE_SIZE - 1))\n\n# Compute MD5 hash\nHASH=$(md5sum /path/to/audio.mp3 | awk '{print $1}')\n\nThen upload via multipart form-data with the Content-Range header:\n\ncurl -s -X POST \"https://api-w3stream.attoaioz.cyou/api/videos/AUDIO_ID/part\" \\\n  -H 'stream-public-key: PUBLIC_KEY' \\\n  -H 'stream-secret-key: SECRET_KEY' \\\n  -H \"Content-Range: bytes 0-$END_POS/$FILE_SIZE\" \\\n  -F \"file=@/path/to/audio.mp3\" \\\n  -F \"index=0\" \\\n  -F \"hash=$HASH\"\n\nImportant: The Content-Range header is required for the upload to succeed. Format: bytes {start}-{end}/{total_size} where:\n\nFor single-part uploads: start=0, end=file_size-1, total_size=file_size\nFor multi-part uploads: adjust start/end positions for each chunk\n\nForm-data fields:\n\nfile: the audio file binary (use @/path/to/file)\nindex: 0 (for single-part upload, increment for multi-part)\nhash: MD5 hash of the file part"
      },
      {
        "title": "Step 3: Complete Upload",
        "body": "After the file part is uploaded, call the complete endpoint to finalize:\n\ncurl -s -X GET \"https://api-w3stream.attoaioz.cyou/api/videos/AUDIO_ID/complete\" \\\n  -H 'accept: application/json' \\\n  -H 'stream-public-key: PUBLIC_KEY' \\\n  -H 'stream-secret-key: SECRET_KEY'\n\nThis triggers transcoding. The upload is now considered successful."
      },
      {
        "title": "After Upload — Get Audio Link",
        "body": "After completing the upload, fetch the audio detail to get the streaming URL:\n\ncurl -s 'https://api-w3stream.attoaioz.cyou/api/videos/AUDIO_ID' \\\n  -H 'stream-public-key: PUBLIC_KEY' \\\n  -H 'stream-secret-key: SECRET_KEY'\n\nParse the response to find the HLS URL from the assets or hls field and return it to the user.\n\nImportant: Audio outputs do NOT have an mp4_url field. Only HLS/DASH streaming links are available."
      },
      {
        "title": "Quality Presets (resolution field):",
        "body": "standard — Standard quality\ngood — Good quality\nhighest — Highest quality\nlossless — Lossless quality"
      },
      {
        "title": "Streaming Formats (type field):",
        "body": "hls — HTTP Live Streaming (container: mpegts or mp4)\ndash — Dynamic Adaptive Streaming (container: fmp4)"
      },
      {
        "title": "Audio Config:",
        "body": "codec: aac (only supported codec)\nbitrate: integer in bits/sec (e.g., 128000, 256000, 320000)\nchannels: \"2\" (stereo)\nsample_rate: 8000, 11025, 16000, 22050, 32000, 44100, 48000, 88200, 96000\nlanguage: BCP 47 code (e.g., en, vi)\nindex: 0"
      },
      {
        "title": "Recommended bitrates:",
        "body": "Podcast/Voice: 64000 - 128000 bps\nMusic standard: 128000 - 192000 bps\nMusic high quality: 192000 - 256000 bps\nMusic highest: 256000 - 320000 bps"
      },
      {
        "title": "Recommended sample rates:",
        "body": "Voice: 22050 or 32000\nMusic: 44100 or 48000"
      },
      {
        "title": "Response Handling",
        "body": "Parse the JSON response from the create call → extract data.id\nCompute MD5 hash of the audio file\nUpload the file part with the hash\nCall complete endpoint\nFetch audio detail to get streaming URL\nReturn the audio link to the user\nIf the audio is still transcoding (status: transcoding), inform the user and suggest checking back later"
      },
      {
        "title": "Error Handling",
        "body": "401: Invalid API keys — ask user to verify their public and secret keys\n400: Bad request — check the request body format\n500: Server error — suggest retrying"
      },
      {
        "title": "Example Interaction Flow",
        "body": "User: \"Upload my audio to AIOZ Stream\"\nAsk for API keys (public + secret) if not known\nAsk for the audio file path\nAsk: \"Default upload (quick) or custom config?\"\n\nIf default: ask for title only\nIf custom: ask for title, quality preset, bitrate, sample rate, tags, etc.\n\n\nStep 1: Create audio object → get AUDIO_ID\nStep 2: Compute file hash, upload file part\nStep 3: Call complete endpoint\nFetch audio detail → return streaming URL to user"
      }
    ],
    "body": "AIOZ Stream Audio Upload\n\nUpload audio to AIOZ Stream API quickly with API key authentication. The full upload flow requires 3 API calls: Create → Upload Part → Complete.\n\nWhen to use this skill\nUser wants to upload or create an audio on AIOZ Stream\nUser mentions \"upload audio\", \"create audio\", \"aioz stream audio\"\nUser wants to get an HLS streaming link for their audio\nAuthentication\n\nThis skill uses API key authentication. The user must provide:\n\nstream-public-key: their AIOZ Stream public key\nstream-secret-key: their AIOZ Stream secret key\n\nAsk the user for these keys if not provided. They will be sent as HTTP headers on ALL API calls.\n\nUsage Options\n\nWhen the user wants to upload audio, ask them to choose:\n\nOption 1: Default Upload (Quick)\n\nCreates an audio object with minimal config — just a title. Then uploads the file.\n\nExample user prompt:\n\n\"Upload audio file /path/to/audio.mp3 with title My Podcast\"\n\nOption 2: Custom Upload (Advanced)\n\nCreates an audio object with full encoding configuration including quality presets, bitrate, sample rate, tags, metadata, etc. Then uploads the file.\n\nExample user prompt:\n\n\"Upload audio with custom config: title My Podcast, highest quality HLS, 320kbps, 48000Hz, tags podcast,tech\"\n\nFull Upload Flow (3 Steps)\nStep 1: Create Audio Object\n\nDefault:\n\ncurl -s -X POST 'https://api-w3stream.attoaioz.cyou/api/videos/create' \\\n  -H 'stream-public-key: PUBLIC_KEY' \\\n  -H 'stream-secret-key: SECRET_KEY' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"title\": \"AUDIO_TITLE\",\n    \"type\": \"audio\"\n  }'\n\n\nCustom (with encoding config):\n\ncurl -s -X POST 'https://api-w3stream.attoaioz.cyou/api/videos/create' \\\n  -H 'stream-public-key: PUBLIC_KEY' \\\n  -H 'stream-secret-key: SECRET_KEY' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"title\": \"AUDIO_TITLE\",\n    \"type\": \"audio\",\n    \"description\": \"DESCRIPTION\",\n    \"is_public\": true,\n    \"tags\": [\"tag1\", \"tag2\"],\n    \"metadata\": [\n      {\"key\": \"KEY\", \"value\": \"VALUE\"}\n    ],\n    \"qualities\": [\n      {\n        \"resolution\": \"highest\",\n        \"type\": \"hls\",\n        \"container_type\": \"mpegts\",\n        \"audio_config\": {\n          \"codec\": \"aac\",\n          \"bitrate\": 320000,\n          \"channels\": \"2\",\n          \"sample_rate\": 48000,\n          \"language\": \"en\",\n          \"index\": 0\n        }\n      },\n      {\n        \"resolution\": \"standard\",\n        \"type\": \"hls\",\n        \"container_type\": \"mpegts\",\n        \"audio_config\": {\n          \"codec\": \"aac\",\n          \"bitrate\": 128000,\n          \"channels\": \"2\",\n          \"sample_rate\": 44100,\n          \"language\": \"en\",\n          \"index\": 0\n        }\n      }\n    ]\n  }'\n\n\nResponse: Extract data.id — this is the AUDIO_ID used in the next steps.\n\nStep 2: Upload File Part\n\nUpload the actual audio file binary to the created audio object.\n\nFirst, get the file size and compute the MD5 hash:\n\n# Get file size (cross-platform compatible)\nFILE_SIZE=$(stat -f%z /path/to/audio.mp3 2>/dev/null || stat -c%s /path/to/audio.mp3)\nEND_POS=$((FILE_SIZE - 1))\n\n# Compute MD5 hash\nHASH=$(md5sum /path/to/audio.mp3 | awk '{print $1}')\n\n\nThen upload via multipart form-data with the Content-Range header:\n\ncurl -s -X POST \"https://api-w3stream.attoaioz.cyou/api/videos/AUDIO_ID/part\" \\\n  -H 'stream-public-key: PUBLIC_KEY' \\\n  -H 'stream-secret-key: SECRET_KEY' \\\n  -H \"Content-Range: bytes 0-$END_POS/$FILE_SIZE\" \\\n  -F \"file=@/path/to/audio.mp3\" \\\n  -F \"index=0\" \\\n  -F \"hash=$HASH\"\n\n\nImportant: The Content-Range header is required for the upload to succeed. Format: bytes {start}-{end}/{total_size} where:\n\nFor single-part uploads: start=0, end=file_size-1, total_size=file_size\nFor multi-part uploads: adjust start/end positions for each chunk\n\nForm-data fields:\n\nfile: the audio file binary (use @/path/to/file)\nindex: 0 (for single-part upload, increment for multi-part)\nhash: MD5 hash of the file part\nStep 3: Complete Upload\n\nAfter the file part is uploaded, call the complete endpoint to finalize:\n\ncurl -s -X GET \"https://api-w3stream.attoaioz.cyou/api/videos/AUDIO_ID/complete\" \\\n  -H 'accept: application/json' \\\n  -H 'stream-public-key: PUBLIC_KEY' \\\n  -H 'stream-secret-key: SECRET_KEY'\n\n\nThis triggers transcoding. The upload is now considered successful.\n\nAfter Upload — Get Audio Link\n\nAfter completing the upload, fetch the audio detail to get the streaming URL:\n\ncurl -s 'https://api-w3stream.attoaioz.cyou/api/videos/AUDIO_ID' \\\n  -H 'stream-public-key: PUBLIC_KEY' \\\n  -H 'stream-secret-key: SECRET_KEY'\n\n\nParse the response to find the HLS URL from the assets or hls field and return it to the user.\n\nImportant: Audio outputs do NOT have an mp4_url field. Only HLS/DASH streaming links are available.\n\nCustom Upload Config Reference\nQuality Presets (resolution field):\nstandard — Standard quality\ngood — Good quality\nhighest — Highest quality\nlossless — Lossless quality\nStreaming Formats (type field):\nhls — HTTP Live Streaming (container: mpegts or mp4)\ndash — Dynamic Adaptive Streaming (container: fmp4)\nAudio Config:\ncodec: aac (only supported codec)\nbitrate: integer in bits/sec (e.g., 128000, 256000, 320000)\nchannels: \"2\" (stereo)\nsample_rate: 8000, 11025, 16000, 22050, 32000, 44100, 48000, 88200, 96000\nlanguage: BCP 47 code (e.g., en, vi)\nindex: 0\nRecommended bitrates:\nPodcast/Voice: 64000 - 128000 bps\nMusic standard: 128000 - 192000 bps\nMusic high quality: 192000 - 256000 bps\nMusic highest: 256000 - 320000 bps\nRecommended sample rates:\nVoice: 22050 or 32000\nMusic: 44100 or 48000\nResponse Handling\nParse the JSON response from the create call → extract data.id\nCompute MD5 hash of the audio file\nUpload the file part with the hash\nCall complete endpoint\nFetch audio detail to get streaming URL\nReturn the audio link to the user\nIf the audio is still transcoding (status: transcoding), inform the user and suggest checking back later\nError Handling\n401: Invalid API keys — ask user to verify their public and secret keys\n400: Bad request — check the request body format\n500: Server error — suggest retrying\nExample Interaction Flow\nUser: \"Upload my audio to AIOZ Stream\"\nAsk for API keys (public + secret) if not known\nAsk for the audio file path\nAsk: \"Default upload (quick) or custom config?\"\nIf default: ask for title only\nIf custom: ask for title, quality preset, bitrate, sample rate, tags, etc.\nStep 1: Create audio object → get AUDIO_ID\nStep 2: Compute file hash, upload file part\nStep 3: Call complete endpoint\nFetch audio detail → return streaming URL to user"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/vinhbui3004/audio-upload-aioz-stream",
    "publisherUrl": "https://clawhub.ai/vinhbui3004/audio-upload-aioz-stream",
    "owner": "vinhbui3004",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/audio-upload-aioz-stream",
    "downloadUrl": "https://openagent3.xyz/downloads/audio-upload-aioz-stream",
    "agentUrl": "https://openagent3.xyz/skills/audio-upload-aioz-stream/agent",
    "manifestUrl": "https://openagent3.xyz/skills/audio-upload-aioz-stream/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/audio-upload-aioz-stream/agent.md"
  }
}