USA AI Sandbox Guide

Azure · OpenAI / ChatGPT API Practice · Gemini Later

Key Submit: https://usasanbox.homelinked.tech/key/

Purpose: Practice sudo, Python Runtime, AI API calls, public URL, API URL and handoff.

Boundary: test-only, low-limit keys only, no company secrets.

1. Submit SSH Public Key

https://usasanbox.homelinked.tech/key/

2. Login

Login Success · 登录成功后你会看到什么

If login is successful, your terminal will show something like:

如果登录成功，你的终端会显示类似：

kyle@Gmall:~$
angela@Gmall:~$
kelvin@Gmall:~$

This means you are already inside the Azure AI Sandbox server.

这代表你已经进入 Azure AI Sandbox 服务器。

Then run:

cd ~/work
ls
cat app.py

Do not type only the IP or domain.

不要只输入 IP 或域名。

Wrong:

172.203.217.218
usasanbox.homelinked.tech

Correct:

ssh yourname@172.203.217.218

Example:

ssh kyle@172.203.217.218

ssh yourname@172.203.217.218

3. Prepare AI API env

cd ~/work
cp .env.example .env
nano .env

Example:

OPENAI_API_KEY=your_test_openai_key
OPENAI_MODEL=gpt-4o-mini

GEMINI_API_KEY=your_test_gemini_key
GEMINI_MODEL=gemini-3.5-flash

4. Restart Your Runtime

sudo systemctl restart usaai-yourname
sudo systemctl status usaai-yourname --no-pager

5. Test URLs

https://usasanbox.homelinked.tech/yourname/api/
https://usasanbox.homelinked.tech/yourname/api/ai/status
https://usasanbox.homelinked.tech/yourname/api/ai/openai?prompt=Say%20hello
https://usasanbox.homelinked.tech/yourname/api/ai/gemini?prompt=Say%20hello

6. Already Exists Problem

If your computer says id_ed25519 already exists, press n.
Then run:
cat ~/.ssh/id_ed25519.pub

Submit the ssh-ed25519 AAAA... line to:
https://usasanbox.homelinked.tech/key/

Current AI Provider Rule · 当前 AI Provider 规则

Use ChatGPT / OpenAI API first

本阶段先使用 ChatGPT / OpenAI API

Current allowed practice:
OpenAI / ChatGPT API only

Gemini:
Not used now
Do not add Gemini key unless Admin confirms later

Admin will provide a ChatGPT / OpenAI test key or instruction.

Admin 会提供 ChatGPT / OpenAI 的测试 Key 或指引。

Do not upload or share your key publicly. Put it only inside ~/work/.env.

不要公开或发送你的 Key。只把它放在 ~/work/.env。

Important

Do not put API key inside app.py
Do not paste API key into public webpage
Do not send API key in WhatsApp group
Do not upload .env
Do not commit .env to GitHub
Do not use company production key
Use test key only

First AI Success · 第一个 AI 成功

First target: safely send one Prompt to OpenAI and receive one answer.

第一目标： 安全地把一个 Prompt 发给 OpenAI，并收到一个答案。

Read the simple success definition:

请先看简易成功定义：

https://usasanbox.homelinked.tech/first-success/

Safe Python AI Demo · 安全 Python AI 示例

This demo teaches how to call OpenAI / ChatGPT API first. Google Gemini API later (later) without exposing your API keys.

这个示例教你如何调用先练习 OpenAI / ChatGPT API。Google Gemini API 以后再启用 (later)，同时不暴露你的 API Key。

Step 1 · Login

ssh yourname@172.203.217.218

If login is successful, you may see:

yourname@Gmall:~$

Step 2 · Go to your work folder

cd ~/work
ls
cat README_FIRST_AI.md

Step 3 · Create your .env file

cp .env.example .env
nano .env

Add your own test keys:

DEMO_TOKEN=your_random_demo_token
OPENAI_API_KEY=your_test_openai_key
OPENAI_MODEL=gpt-4o-mini

GEMINI_API_KEY=your_test_gemini_key
GEMINI_MODEL=gemini-3.5-flash

Create a random DEMO_TOKEN:

python3 -c "import secrets; print(secrets.token_urlsafe(12))"

Protect the file:

chmod 600 .env

Step 4 · Restart your Runtime

sudo systemctl restart usaai-yourname
sudo systemctl status usaai-yourname --no-pager

Examples:

sudo systemctl restart usaai-kyle
sudo systemctl restart usaai-kelvin
sudo systemctl restart usaai-angela

Step 5 · Check AI status

https://usasanbox.homelinked.tech/yourname/api/ai/status

This only shows whether keys exist. It never prints your keys.

这里只显示 Key 是否存在，不会显示 Key 内容。

Step 6 · Test OpenAI / ChatGPT API

https://usasanbox.homelinked.tech/yourname/api/ai/openai?prompt=Say%20hello&token=YOUR_DEMO_TOKEN

Step 7 · Test Google Gemini API (later)

https://usasanbox.homelinked.tech/yourname/api/ai/gemini?prompt=Say%20hello&token=YOUR_DEMO_TOKEN

Important Safety Rule · 重要安全规则

Never put API keys in app.py
Never publish .env
Never send private key
Never upload company secrets
Never upload customer data
Use test keys only

不要把 API Key 写进 app.py
不要公开 .env
不要发送 SSH 私钥
不要上传公司 Secret
不要上传客户资料
只使用测试 Key

First Complete AI Success · 第一个完整 AI 成功

1. Login
2. cd ~/work
3. Create .env
4. Add DEMO_TOKEN and one test API key
5. Restart service
6. Open /api/ai/status
7. Run one OpenAI / ChatGPT test URL first
8. Screenshot
9. Write:
   Today I Made
   Today I Tried
   Next Step

7. First Complete AI Success

1. Login
2. Add test API key into .env
3. Restart service
4. Open /api/ai/status
5. Run one OpenAI / ChatGPT test URL first
6. Screenshot
7. Write:
   Today I Made
   Today I Tried
   Next Step

Safety

Do not upload:
private key
company API key
production Stripe key
customer data
personal data
confidential files

Because students have sudo, shared secrets are not truly isolated.
Use test keys only.

Guide corrected 2026-07-30 14:35 HKT: SSH IP is 172.203.217.218. Login prompt may show yourname@Gmall.

Safe AI Demo updated 2026-07-30 14:52 HKT

OpenAI-only training notice updated 2026-07-30 14:55 HKT. Gemini is not used now.