mirror of
https://github.com/AceDataCloud/Skills.git
synced 2026-09-14 20:06:53 +08:00
fix: use .env file for token setup instead of bare export (#43)
Previously, authentication.md told users to `export ACEDATACLOUD_API_TOKEN=...` directly in the shell with no guidance on where to persist it. Now instructs users to create a `.env` file in the project root and `source .env`, which is more standard and persistent across sessions. Also updates all 19 skill compatibility fields to reference the .env setup. Co-authored-by: Ace Data Cloud Dev <dev@acedata.cloud> Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -2,17 +2,29 @@
|
||||
|
||||
All AceDataCloud APIs use Bearer token authentication.
|
||||
|
||||
## Get Your Token
|
||||
|
||||
1. Register at [platform.acedata.cloud](https://platform.acedata.cloud)
|
||||
2. Subscribe to a service (most include free quota)
|
||||
3. Go to your service's **Credentials** page and create an API token
|
||||
|
||||
## Setup
|
||||
|
||||
Create a `.env` file in your project root:
|
||||
|
||||
```bash
|
||||
export ACEDATACLOUD_API_TOKEN="your-token-here"
|
||||
ACEDATACLOUD_API_TOKEN=your_token_here
|
||||
```
|
||||
|
||||
Get your token at [platform.acedata.cloud](https://platform.acedata.cloud):
|
||||
Then load it before making API calls:
|
||||
|
||||
1. Register an account
|
||||
2. Browse and subscribe to a service (most include free quota)
|
||||
3. Create an API credential (token)
|
||||
```bash
|
||||
source .env
|
||||
```
|
||||
|
||||
> **Agent usage:** If you're running skills through Claude Code or another AI agent, the agent will automatically `source .env` from the project root before calling any API.
|
||||
|
||||
> **Important:** Add `.env` to your `.gitignore` — never commit tokens to version control.
|
||||
|
||||
## Usage
|
||||
|
||||
@@ -23,9 +35,14 @@ curl -X POST https://api.acedata.cloud/<endpoint> \
|
||||
-d '{ ... }'
|
||||
```
|
||||
|
||||
### Token Types
|
||||
## Token Types
|
||||
|
||||
| Type | Scope |
|
||||
|------|-------|
|
||||
| **Service Token** | Access to one subscribed service only |
|
||||
| **Global Token** | Access to all subscribed services |
|
||||
| Type | Scope | Use Case |
|
||||
|------|-------|----------|
|
||||
| **Service Token** | Single service | Default. Created per-subscription |
|
||||
| **Global Token** | All services | Create from the platform's global credentials page |
|
||||
|
||||
## Gotchas
|
||||
|
||||
- Tokens are **service-scoped** by default — if you get a 401 on a different service, create a global token or a token for that specific service
|
||||
- Tokens do not expire, but can be revoked from the platform
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Works as a drop-in replacement for the OpenAI SDK.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Works as a drop-in replacement for the OpenAI SDK.
|
||||
---
|
||||
|
||||
# AI Chat — Unified LLM Gateway
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
|
||||
---
|
||||
|
||||
# Face Transform
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
|
||||
---
|
||||
|
||||
# Fish Audio — Voice & Audio Synthesis
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-flux-pro for tool-use.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-flux-pro for tool-use.
|
||||
---
|
||||
|
||||
# Flux Image Generation
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-serp for tool-use.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-serp for tool-use.
|
||||
---
|
||||
|
||||
# Google Search (SERP)
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
|
||||
---
|
||||
|
||||
# Hailuo Video Generation
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
|
||||
---
|
||||
|
||||
# Kling Video Generation
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-luma for tool-use.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-luma for tool-use.
|
||||
---
|
||||
|
||||
# Luma Video Generation
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-midjourney for tool-use.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-midjourney for tool-use.
|
||||
---
|
||||
|
||||
# Midjourney Image Generation
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-nano-banana for tool-use.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-nano-banana for tool-use.
|
||||
---
|
||||
|
||||
# NanoBanana Image Generation
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
|
||||
---
|
||||
|
||||
# Producer Music Generation
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-seedance for tool-use.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-seedance for tool-use.
|
||||
---
|
||||
|
||||
# Seedance Video Generation
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-seedream for tool-use.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-seedream for tool-use.
|
||||
---
|
||||
|
||||
# Seedream Image Generation
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-short-url for tool-use.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-short-url for tool-use.
|
||||
---
|
||||
|
||||
# Short URL Service
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-sora for tool-use.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-sora for tool-use.
|
||||
---
|
||||
|
||||
# Sora Video Generation
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-suno for tool-use.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-suno for tool-use.
|
||||
---
|
||||
|
||||
# Suno Music Generation
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-veo for tool-use.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-veo for tool-use.
|
||||
---
|
||||
|
||||
# Veo Video Generation
|
||||
|
||||
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-wan for tool-use.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-wan for tool-use.
|
||||
---
|
||||
|
||||
# Wan Video Generation
|
||||
|
||||
+1
-1
@@ -5,7 +5,7 @@ license: Apache-2.0
|
||||
metadata:
|
||||
author: acedatacloud
|
||||
version: "1.0"
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable.
|
||||
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
|
||||
---
|
||||
|
||||
# Template Skill
|
||||
|
||||
Reference in New Issue
Block a user