Volcengine (Doubao)

ผู้ให้บริการ Volcengine ช่วยให้เข้าถึงโมเดล Doubao และโมเดลของบุคคลที่สามที่โฮสต์บน Volcano Engine โดยมีปลายทางแยกกันสำหรับเวิร์กโหลดทั่วไปและงานเขียนโค้ด Plugin ที่รวมมาให้เดียวกันนี้ยังลงทะเบียน Volcengine Speech เป็นผู้ให้บริการ TTS ด้วย

เริ่มต้นใช้งาน

openclaw onboard --auth-choice volcengine-api-key

{  agents: {    defaults: {      model: { primary: "volcengine-plan/ark-code-latest" },    },  },}

openclaw models list --provider volcengineopenclaw models list --provider volcengine-plan

ผู้ให้บริการและปลายทาง

แค็ตตาล็อกในตัว

แค็ตตาล็อกทั้งสองเป็นแบบคงที่ (ไม่มีการเรียกค้นหา /models) และรองรับการบัญชีการใช้งานแบบสตรีมที่เข้ากันได้กับ OpenAI สคีมาเครื่องมือสำหรับผู้ให้บริการทั้งสองจะตัดคีย์เวิร์ด minLength, maxLength, minItems, maxItems, minContains และ maxContains ออกโดยอัตโนมัติ เนื่องจาก API การเรียกใช้เครื่องมือของ Volcengine ปฏิเสธคีย์เวิร์ดเหล่านี้

การแปลงข้อความเป็นเสียงพูด

Volcengine TTS ใช้ BytePlus Seed Speech HTTP API (voice.ap-southeast-1.bytepluses.com) และกำหนดค่าแยกจากคีย์ API ของโมเดล Doubao ที่เข้ากันได้กับ OpenAI ในคอนโซล BytePlus ให้เปิด Seed Speech > Settings > API Keys คัดลอกคีย์ API แล้วตั้งค่า:

export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"

จากนั้นเปิดใช้งานใน openclaw.json:

{  messages: {    tts: {      auto: "always",      provider: "volcengine",      providers: {        volcengine: {          apiKey: "byteplus_seed_speech_api_key",          voice: "en_female_anna_mars_bigtts",          speedRatio: 1.0,        },      },    },  },}

ฟิลด์ที่ใช้ได้ภายใต้ messages.tts.providers.volcengine: apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey และ baseUrl นอกจากนี้ !emotion=<value> ยังใช้เป็นไดเรกทีฟเสียงแบบอินไลน์ได้ เมื่ออนุญาตให้แทนที่การตั้งค่าเสียง

สำหรับเป้าหมายที่เป็นข้อความเสียง OpenClaw จะร้องขอ ogg_opus แบบเนทีฟของผู้ให้บริการ ส่วนไฟล์แนบเสียงทั่วไปจะร้องขอ mp3 นามแฝงผู้ให้บริการ bytedance และ doubao จะถูกแก้ไปยังผู้ให้บริการเสียงพูดนี้เช่นกัน

รหัสทรัพยากรเริ่มต้นคือ seed-tts-1.0 ซึ่งเป็นสิทธิ์ที่ BytePlus มอบให้คีย์ API ของ Seed Speech ที่สร้างใหม่โดยค่าเริ่มต้น หากโปรเจกต์มีสิทธิ์ TTS 2.0 ให้ตั้งค่า VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0

ยังคงรองรับการยืนยันตัวตนด้วย AppID/โทเค็นแบบเดิมสำหรับแอปพลิเคชัน Speech Console รุ่นเก่า:

export VOLCENGINE_TTS_APPID="speech_app_id"export VOLCENGINE_TTS_TOKEN="speech_access_token"export VOLCENGINE_TTS_CLUSTER="volcano_tts"

ตัวแปรสภาพแวดล้อม TTS อื่นที่เป็นทางเลือก ได้แก่ VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY และ VOLCENGINE_TTS_BASE_URL ซึ่งจะแทนที่ฟิลด์การกำหนดค่า messages.tts.providers.volcengine ที่สอดคล้องกันเมื่อมีการตั้งค่า

การกำหนดค่าขั้นสูง

ที่เกี่ยวข้อง