Typst & LaTeX 在线编译器 API - 将 .typ 和 .tex 文档编译为 PDF

The Agent Skills Directory

安装命令

npx skills add https://smithery.ai/skills/openclaw/typst-latex-compiler

内容创作 LaTeX API

🇨🇳中文介绍

Typst & LaTeX 编译器

使用 TypeTex 编译 API 将 Typst (.typ) 和 LaTeX (.tex) 文档编译为 PDF。

API 端点

基础 URL: https://studio-intrinsic--typetex-compile-app.modal.run

端点

编译 Typst

POST /public/compile/typst
Content-Type: application/json

请求体:

{
  "content": "#set page(paper: \"a4\")\n\n= Hello World\n\nThis is a Typst document.",
  "main_filename": "main.typ",
  "auxiliary_files": {}
}

响应 (成功):

{
  "success": true,
  "pdf_base64": "JVBERi0xLjQK..."
}

响应 (失败):

{
  "success": false,
  "error": "error: file not found: missing.typ"
}

编译 LaTeX

POST /public/compile/latex
Content-Type: application/json

请求体:

{
  "content": "\\documentclass{article}\n\\begin{document}\nHello World\n\\end{document}",
  "main_filename": "main.tex",
  "auxiliary_files": {}
}

响应 (成功):

{
  "success": true,
  "pdf_base64": "JVBERi0xLjQK..."
}

响应 (失败):

{
  "success": false,
  "error": "! LaTeX Error: Missing \\begin{document}.",
  "log_output": "This is pdfTeX..."
}

健康检查

GET /public/compile/health

如果服务正在运行，则返回 {"status": "ok", "service": "public-compile"}。

使用示例

简单的 Typst 文档

import requests
import base64

response = requests.post(
    "https://studio-intrinsic--typetex-compile-app.modal.run/public/compile/typst",
    json={
        "content": """
#set page(paper: "a4", margin: 2cm)
#set text(font: "New Computer Modern", size: 11pt)

= My Document

This is a paragraph with *bold* and _italic_ text.

== Section 1

- Item 1
- Item 2
- Item 3
""",
        "main_filename": "main.typ"
    }
)

result = response.json()
if result["success"]:
    pdf_bytes = base64.b64decode(result["pdf_base64"])
    with open("output.pdf", "wb") as f:
        f.write(pdf_bytes)
    print("PDF saved to output.pdf")
else:
    print(f"Compilation failed: {result['error']}")

简单的 LaTeX 文档

import requests
import base64

response = requests.post(
    "https://studio-intrinsic--typetex-compile-app.modal.run/public/compile/latex",
    json={
        "content": r"""
\documentclass[11pt]{article}
\usepackage[margin=1in]{geometry}
\usepackage{amsmath}

\title{My Document}
\author{Author Name}

\begin{document}
\maketitle

\section{Introduction}

This is a LaTeX document with math: $E = mc^2$

\end{document}
""",
        "main_filename": "main.tex"
    }
)

result = response.json()
if result["success"]:
    pdf_bytes = base64.b64decode(result["pdf_base64"])
    with open("output.pdf", "wb") as f:
        f.write(pdf_bytes)
else:
    print(f"Compilation failed: {result['error']}")
    if result.get("log_output"):
        print(f"Log: {result['log_output']}")

多文件项目 (Typst)

import requests
import base64

response = requests.post(
    "https://studio-intrinsic--typetex-compile-app.modal.run/public/compile/typst",
    json={
        "content": """
#import "template.typ": *

#show: project.with(title: "My Report")

= Introduction

#include "chapter1.typ"
""",
        "main_filename": "main.typ",
        "auxiliary_files": {
            "template.typ": """
#let project(title: none, body) = {
  set page(paper: "a4")
  set text(font: "New Computer Modern")

  align(center)[
    #text(size: 24pt, weight: "bold")[#title]
  ]

  body
}
""",
            "chapter1.typ": """
== Chapter 1

This is the first chapter.
"""
        }
    }
)

result = response.json()
if result["success"]:
    pdf_bytes = base64.b64decode(result["pdf_base64"])
    with open("report.pdf", "wb") as f:
        f.write(pdf_bytes)

包含图片

对于图片等二进制文件，请使用 base64 编码：

import requests
import base64

# 读取并编码图片
with open("figure.png", "rb") as f:
    image_base64 = base64.b64encode(f.read()).decode("utf-8")

response = requests.post(
    "https://studio-intrinsic--typetex-compile-app.modal.run/public/compile/typst",
    json={
        "content": """
#set page(paper: "a4")

= Document with Image

#figure(
  image("figure.png", width: 80%),
  caption: [A sample figure]
)
""",
        "main_filename": "main.typ",
        "auxiliary_files": {
            "figure.png": image_base64
        }
    }
)

使用 curl

# Typst 编译
curl -X POST https://studio-intrinsic--typetex-compile-app.modal.run/public/compile/typst \
  -H "Content-Type: application/json" \
  -d '{
    "content": "#set page(paper: \"a4\")\n\n= Hello World\n\nThis is Typst.",
    "main_filename": "main.typ"
  }' | jq -r '.pdf_base64' | base64 -d > output.pdf

# LaTeX 编译
curl -X POST https://studio-intrinsic--typetex-compile-app.modal.run/public/compile/latex \
  -H "Content-Type: application/json" \
  -d '{
    "content": "\\documentclass{article}\n\\begin{document}\nHello World\n\\end{document}",
    "main_filename": "main.tex"
  }' | jq -r '.pdf_base64' | base64 -d > output.pdf

支持的功能

Typst

完整的 Typst 语言支持
支持导入的多文件项目
图片 (PNG, JPG, SVG)
自定义字体 (New Computer Modern 等)
数学公式
表格和图表
参考文献 (使用 Hayagriva 格式)

LaTeX

通过 Tectonic 提供完整的 TeX Live 发行版
多文件项目 (\input, \include)
BibTeX/BibLaTeX 参考文献
自定义样式文件 (.sty, .cls)
所有标准包 (amsmath, graphicx 等)
TikZ/PGFPlots 图形
图片 (PNG, JPG, PDF, EPS)

错误处理

当编译失败时，响应包含：

success: false
error: 人类可读的错误信息
log_output (仅限 LaTeX): 用于调试的完整编译日志

常见错误：

语法错误 : 检查源代码中的拼写错误
文件缺失 : 确保所有导入/包含的文件都在 auxiliary_files 中
包未找到 : 大多数常用包都可用；如需添加请联系支持
超时 : 复杂文档可能在 60 秒后超时

速率限制

无需身份验证
请尊重共享资源
如需高频率使用，请联系支持

给代理的提示

始终检查 success 字段，然后再访问 pdf_base64
解析错误信息，以便向用户提供有用的反馈
测试时使用最简单的文档 - 复杂文档编译时间更长
缓存结果，如果多次编译相同的内容
将所有依赖项包含在 auxiliary_files 中，用于多文件项目

🇺🇸English

Typst & LaTeX Compiler

Compile Typst (.typ) and LaTeX (.tex) documents to PDF using the TypeTex compilation API.

API Endpoint

Base URL: https://studio-intrinsic--typetex-compile-app.modal.run

Endpoints

Compile Typst

POST /public/compile/typst
Content-Type: application/json

Request Body:

{
  "content": "#set page(paper: \"a4\")\n\n= Hello World\n\nThis is a Typst document.",
  "main_filename": "main.typ",
  "auxiliary_files": {}
}

Response (Success):

{
  "success": true,
  "pdf_base64": "JVBERi0xLjQK..."
}

Response (Failure):

{
  "success": false,
  "error": "error: file not found: missing.typ"
}

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

Simple Typst Document

import requests
import base64

response = requests.post(
    "https://studio-intrinsic--typetex-compile-app.modal.run/public/compile/typst",
    json={
        "content": """
#set page(paper: "a4", margin: 2cm)
#set text(font: "New Computer Modern", size: 11pt)

= My Document

This is a paragraph with *bold* and _italic_ text.

== Section 1

- Item 1
- Item 2
- Item 3
""",
        "main_filename": "main.typ"
    }
)

result = response.json()
if result["success"]:
    pdf_bytes = base64.b64decode(result["pdf_base64"])
    with open("output.pdf", "wb") as f:
        f.write(pdf_bytes)
    print("PDF saved to output.pdf")
else:
    print(f"Compilation failed: {result['error']}")

Simple LaTeX Document

import requests
import base64

response = requests.post(
    "https://studio-intrinsic--typetex-compile-app.modal.run/public/compile/latex",
    json={
        "content": r"""
\documentclass[11pt]{article}
\usepackage[margin=1in]{geometry}
\usepackage{amsmath}

\title{My Document}
\author{Author Name}

\begin{document}
\maketitle

\section{Introduction}

This is a LaTeX document with math: $E = mc^2$

\end{document}
""",
        "main_filename": "main.tex"
    }
)

result = response.json()
if result["success"]:
    pdf_bytes = base64.b64decode(result["pdf_base64"])
    with open("output.pdf", "wb") as f:
        f.write(pdf_bytes)
else:
    print(f"Compilation failed: {result['error']}")
    if result.get("log_output"):
        print(f"Log: {result['log_output']}")

Multi-File Project (Typst)

import requests
import base64

response = requests.post(
    "https://studio-intrinsic--typetex-compile-app.modal.run/public/compile/typst",
    json={
        "content": """
#import "template.typ": *

#show: project.with(title: "My Report")

= Introduction

#include "chapter1.typ"
""",
        "main_filename": "main.typ",
        "auxiliary_files": {
            "template.typ": """
#let project(title: none, body) = {
  set page(paper: "a4")
  set text(font: "New Computer Modern")

  align(center)[
    #text(size: 24pt, weight: "bold")[#title]
  ]

  body
}
""",
            "chapter1.typ": """
== Chapter 1

This is the first chapter.
"""
        }
    }
)

result = response.json()
if result["success"]:
    pdf_bytes = base64.b64decode(result["pdf_base64"])
    with open("report.pdf", "wb") as f:
        f.write(pdf_bytes)

For binary files like images, base64-encode them:

import requests
import base64

# Read and encode an image
with open("figure.png", "rb") as f:
    image_base64 = base64.b64encode(f.read()).decode("utf-8")

response = requests.post(
    "https://studio-intrinsic--typetex-compile-app.modal.run/public/compile/typst",
    json={
        "content": """
#set page(paper: "a4")

= Document with Image

#figure(
  image("figure.png", width: 80%),
  caption: [A sample figure]
)
""",
        "main_filename": "main.typ",
        "auxiliary_files": {
            "figure.png": image_base64
        }
    }
)

# Typst compilation
curl -X POST https://studio-intrinsic--typetex-compile-app.modal.run/public/compile/typst \
  -H "Content-Type: application/json" \
  -d '{
    "content": "#set page(paper: \"a4\")\n\n= Hello World\n\nThis is Typst.",
    "main_filename": "main.typ"
  }' | jq -r '.pdf_base64' | base64 -d > output.pdf

# LaTeX compilation
curl -X POST https://studio-intrinsic--typetex-compile-app.modal.run/public/compile/latex \
  -H "Content-Type: application/json" \
  -d '{
    "content": "\\documentclass{article}\n\\begin{document}\nHello World\n\\end{document}",
    "main_filename": "main.tex"
  }' | jq -r '.pdf_base64' | base64 -d > output.pdf

Full Typst language support
Multi-file projects with imports
Images (PNG, JPG, SVG)
Custom fonts (New Computer Modern, etc.)
Math equations
Tables and figures
Bibliography (using Hayagriva format)

Full TeX Live distribution via Tectonic
Multi-file projects (\input, \include)
BibTeX/BibLaTeX bibliography
Custom style files (.sty, .cls)
All standard packages (amsmath, graphicx, etc.)
TikZ/PGFPlots graphics
Images (PNG, JPG, PDF, EPS)

When compilation fails, the response includes:

success: false
error: Human-readable error message
log_output (LaTeX only): Full compilation log for debugging

Syntax errors : Check your source code for typos
Missing files : Ensure all imported/included files are in auxiliary_files
Package not found : Most common packages are available; contact support for additions
Timeout : Complex documents may timeout after 60 seconds

No authentication required
Please be respectful of shared resources
For high-volume usage, contact support

Always checksuccess before accessing pdf_base64
Parse errors to provide helpful feedback to users
Use minimal documents when testing - complex documents take longer
Cache results if compiling the same content multiple times
Include all dependencies in auxiliary_files for multi-file projects

Typst Documentation
LaTeX Wikibook
TypeTex - Full document editor with AI assistance

Lark CLI IM 即时消息管理工具：机器人/用户身份操作聊天、消息、文件下载

23,600 周安装

Typst & LaTeX 在线编译器 API - 将 .typ 和 .tex 文档编译为 PDF

🇨🇳中文介绍

Typst & LaTeX 编译器

API 端点

端点

编译 Typst

编译 LaTeX

健康检查

使用示例

简单的 Typst 文档

简单的 LaTeX 文档

多文件项目 (Typst)

包含图片

使用 curl

支持的功能

Typst

LaTeX

错误处理

速率限制

给代理的提示

相关资源

🇺🇸English

Typst & LaTeX Compiler

API Endpoint

Endpoints

Compile Typst

相关 Skills

Compile LaTeX

Health Check

Usage Examples

Simple Typst Document

Simple LaTeX Document

Multi-File Project (Typst)

Including Images

Using curl

Supported Features

Typst

LaTeX

Error Handling

Rate Limits

Tips for Agents

Related Resources

最新 Skills