volcengine-ai-entry-ark

// Entry skill for Volcengine ARK model invocation and routing. Use when users ask to start with ARK, need request templates, endpoint setup, model routing, or authentication troubleshooting.

$ git log --oneline --stat

stars:1,933

forks:367

updated:March 4, 2026

SKILL.mdreadonly

SKILL.md Frontmatter

namevolcengine-ai-entry-ark

descriptionEntry skill for Volcengine ARK model invocation and routing. Use when users ask to start with ARK, need request templates, endpoint setup, model routing, or authentication troubleshooting.

volcengine-ai-entry-ark

Route generic ARK model requests to the right task-specific skill and provide a minimal runnable starting point.

Inputs to Collect

ARK_API_KEY
Model endpoint ID (for example: ep-xxxx)
Task type (chat, summarization, coding, translation)
Optional generation params (temperature, max_tokens, top_p)

Minimal request template

curl https://ark.cn-beijing.volces.com/api/v3/chat/completions \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ep-xxxx",
    "messages": [
      {"role":"system","content":"You are a helpful assistant."},
      {"role":"user","content":"Hello"}
    ],
    "temperature": 0.2
  }'

Troubleshooting Checklist

401: verify ARK_API_KEY and key scope
404: verify endpoint region/domain and endpoint ID
429: reduce request rate and add retries with backoff
5xx: retry with jitter and keep request logs for support

References

references/sources.md