Phase 00: Setup & Tooling

API & Key

Type: Build

Languages: Python, TypeScript

Prerequisites: Phase 0, Lesson 01

Time: ~30 minutes

Mục tiêu học tập

• Cung cấp các khóa API an toàn bằng cách sử dụng các biến môi trường và .envtập tin
• Thực hiện một cuộc gọi LLM API sử dụng cả SDK Python Anthropic và HTTP nguyên liệu
• So sánh các định dạng yêu cầu / phản hồi HTTP dựa trên SDK và nguyên liệu để gỡ lỗi
• Xác định và xử lý các lỗi API phổ biến bao gồm xác thực và giới hạn tỷ lệ

Vấn đề

Bắt đầu từ giai đoạn 11, bạn sẽ gọi LLM API (Anthropic, OpenAI, Google). Trong giai đoạn 13-16 bạn sẽ xây dựng các đại lý sử dụng các API này trong vòng lặp. Bạn cần biết cách API khóa hoạt động, làm thế nào để lưu trữ chúng một cách an toàn, và làm thế nào để thực hiện cuộc gọi API đầu tiên của bạn.

Khái niệm

sequenceDiagram
    participant C as Your Code
    participant S as API Server
    C->>S: HTTP Request (with API key)
    S->>C: HTTP Response (JSON)

Mỗi cuộc gọi API có:

1. Endpoint (URL)
2. Một khóa API (tăng thực)
3. Một cơ quan yêu cầu (bạn muốn gì)
4. Một cơ thể phản ứng (bạn nhận lại)

Hãy xây dựng nó

Bước 1: Cung cấp khóa API an toàn

Đừng bao giờ đặt khóa API vào mã. Sử dụng các biến môi trường.

bashCopyexport ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."

Hoặc sử dụng .envfile (tú thêm vào .gitignore):

CopyANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...

Bước 2: Cuộc gọi API đầu tiên (Python)

pythonCopyimport os

import anthropic

client = anthropic.Anthropic()

MODEL = os.environ.get("LLM_MODEL", "claude-sonnet-5")

response = client.messages.create(
    model=MODEL,
    max_tokens=256,
    messages=[{"role": "user", "content": "What is a neural network in one sentence?"}]
)

print(response.content[0].text)

LLM_MODELchọn ID mô hình Anthropic, và mặc định là tên đếm Sonnet không được cập nhật. Các nhà cung cấp khác (OpenAI, Google, và những người khác) theo cùng một mô hình của một khóa cộng với một ID mô hình, nhưng mỗi người có SDK riêng, điểm cuối và quy trình yêu cầu / phản hồi.

Bước 3: Cuộc gọi API đầu tiên (TypeScript)

typescriptCopyimport Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

const MODEL = process.env.LLM_MODEL ?? "claude-sonnet-5";

const response = await client.messages.create({
  model: MODEL,
  max_tokens: 256,
  messages: [{ role: "user", content: "What is a neural network in one sentence?" }],
});

console.log(response.content[0].text);

Bước 4: HTTP Raw (không có SDK)

pythonCopyimport os
import urllib.request
import json

url = "https://api.anthropic.com/v1/messages"
headers = {
    "Content-Type": "application/json",
    "x-api-key": os.environ["ANTHROPIC_API_KEY"],
    "anthropic-version": "2023-06-01",
}
body = json.dumps({
    "model": os.environ.get("LLM_MODEL", "claude-sonnet-5"),
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "What is a neural network in one sentence?"}],
}).encode()

req = urllib.request.Request(url, data=body, headers=headers, method="POST")
with urllib.request.urlopen(req) as resp:
    result = json.loads(resp.read())
    print(result["content"][0]["text"])

Đây là những gì SDK làm dưới nắp. Hiểu cuộc gọi HTTP nguyên thô giúp khi gỡ lỗi.

Sử dụng nó

Đối với khóa học này:

Anh không cần tất cả chúng ngay bây giờ, hãy đặt chúng lên khi bài học cần.

Chuyển nó

Bài học này mang lại:

• outputs/prompt-api-troubleshooter.md- chẩn đoán các lỗi API phổ biến

Các bài tập

1. Nhận một khóa API Anthropic và thực hiện cuộc gọi API đầu tiên của bạn
2. Hãy thử phiên bản HTTP nguyên liệu và so sánh định dạng phản ứng với phiên bản SDK
3. Ý định sử dụng một khóa API sai và đọc thông báo lỗi

Các điều khoản chính

This free lesson is part of the AI Engineering from Scratch curriculum. Read the full explanation, run the lesson code, and verify the result in the interactive reader or from the repository source.

Browse the complete course catalog or open this lesson on GitHub.