Pertanyaan yang Sering Diajukan

Apa itu AgentGIF?

AgentGIF is a developer GIF hosting platform with dual-layer architecture. Every terminal demo GIF is paired with a machine-readable asciinema v2 cast file, so both humans and AI agents can understand the content.

Manusia melihat rekaman terminal animasi. Agen AI melihat data terstruktur: perintah, output, cap waktu, dan metadata.

Is AgentGIF free?

Ya. Mengunggah, menghosting, dan menyematkan GIF sepenuhnya gratis. REST API gratis untuk operasi baca tanpa autentikasi yang diperlukan. Operasi tulis (unggah, edit, hapus) memerlukan API key gratis dari halaman pengaturan Anda.

What is a cast file?

File cast adalah rekaman asciinema v2. Ini adalah format teks di mana baris 1 adalah header JSON dengan metadata terminal, diikuti oleh tuple event bertanda waktu:

{"version": 2, "width": 120, "height": 40}
[0.5, "o", "$ docker compose up -d\r\n"]
[1.2, "o", "Creating network...\r\n"]
[2.8, "o", "Container app-1  Started\r\n"]

Setiap tuple adalah [timestamp_seconds, event_type, data]. Ini memungkinkan agen AI mengekstrak perintah, output, dan waktu tanpa OCR.

How do I upload a GIF?

Dua opsi:

• Web: Seret dan lepas di /upload/ (memerlukan login GitHub)
• CLI: agentgif upload demo.gif --title "My Demo" --tags cli,unix

CLI tersedia untuk 5 bahasa: Python, Node.js, Go, Rust, dan Ruby. Sertakan flag --cast demo.cast untuk melampirkan lapisan yang dapat dibaca mesin.

Bagaimana cara menyematkan GIF di README saya?

Pola yang direkomendasikan untuk GitHub README:

<p align="center">
  <a href="https://agentgif.com/ID">
    <img src="https://media.agentgif.com/ID.gif" alt="demo" width="800">
  </a>
</p>

Ganti ID dengan ID GIF 8 karakter Anda. Lihat panduan embed lengkap untuk semua 6 metode.

What is the .md endpoint?

Tambahkan .md ke URL AgentGIF mana pun untuk mendapatkan respons text/markdown yang dioptimalkan untuk LLM. Setiap halaman mendukung ini — detail GIF, daftar tag, halaman alat, koleksi, panduan, dan hasil pencarian.

curl https://agentgif.com/tools/git/.md
curl https://agentgif.com/explore/tags/docker/.md

Do I need an API key?

Get a free API key at /settings/ after signing in with GitHub.

What terminal themes are available?

AgentGIF supports all 44 VHS terminal themes. Popular choices:

Jelajahi semua tema dengan pratinjau langsung: Galeri Tema.

What is the badge service?

AgentGIF menyediakan badge paket bertema terminal sebagai alternatif shields.io. Badge dirender dengan warna tema terminal yang Anda pilih.

![PyPI](https://agentgif.com/badge/pypi/requests/version.svg?theme=dracula)
![npm](https://agentgif.com/badge/npm/express/version.svg?theme=nord)
![Stars](https://agentgif.com/badge/github/torvalds/linux/stars.svg)

Penyedia yang didukung: PyPI, npm, crates.io, GitHub. Kustomisasi dengan parameter ?theme= dan ?style=. Lihat playground badge.

How do AI agents read GIFs?

Agen AI dapat mengakses konten GIF melalui beberapa saluran:

• File cast: GET /api/v1/gifs/{id}/cast/ — rekaman asciinema v2 lengkap dengan cap waktu
• Transkrip: GET /api/v1/gifs/{id}/transcript/ — teks biasa bersih, kode ANSI dihapus
• Endpoint .md: Tambahkan .md ke URL halaman mana pun untuk output Markdown
• API JSON: /api/v1/search/?q=docker — pencarian teks lengkap dengan hasil terstruktur
• llms.txt: /llms.txt — ringkasan tingkat situs untuk crawler AI

Lihat dokumentasi integrasi agen AI lengkap.

What file formats are supported?

Untuk hasil terbaik, jaga GIF di bawah 5 MB. Lihat panduan perekaman untuk tips optimasi.

How do I record a terminal GIF?

Kami merekomendasikan VHS oleh Charm untuk rekaman terskrip yang dapat direproduksi:

# Install VHS
brew install vhs

# Create a tape file (demo.tape)
Output demo.gif
Set Theme "Catppuccin Mocha"
Type "echo 'Hello, world!'"
Enter
Sleep 2s

# Record
vhs demo.tape

Instruksi langkah demi langkah lengkap: Cara Merekam GIF Terminal.