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:
Germey
2026-04-07 01:18:17 +08:00
committed by GitHub
parent 921a224d14
commit 290672b0f6
20 changed files with 46 additions and 29 deletions
+27 -10
View File
@@ -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
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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)
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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
View File
@@ -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