Ana içeriğe geç
depth-anything avatarı

Depth Anything V2 API

Tek bir fotoğrafı ControlNet koşullandırması, 3D ve yeniden aydınlatma için gri tonlamalı bir derinlik haritasına dönüştürün — prompt yok, ince ayar yok.

derinlik tahmini
0.01

Model girdisi

Input

URL of the image to generate a depth map from.

You need to be logged in to run this model and view results.
Log in

Model çıktısı

Output

Loading
Generated in 2.345 seconds
Logs (1 lines)

Örnek istekler

Örnekler

Example output 1Example output 2Example output 3

Depth Anything V2 API

Depth Anything V2 is a image-to-image AI model by depth-anything. On ModelRunner it runs through a REST API or via MCP from any AI assistant, at $0.01 per image.

POST https://queue.modelrunner.run/depth-anything/v2

cURL

# Submit a request to the queue. Input fields go at the top level of the
# body. The optional reserved "metadata" object holds your own flat string
# tags — stored on the request, never sent to the model; filter later with
# GET https://queue.modelrunner.run/requests?metadata=<url-encoded JSON>.
curl -X POST https://queue.modelrunner.run/depth-anything/v2 \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://media.modelrunner.ai/x8hj4rin7S47k8s4XhswB.png",
    "metadata": {
      "project": "my-project"
    }
  }'
# → { "request_id": "...", "status_url": "...", "response_url": "..." }

# Poll status_url until "COMPLETED", then fetch the result
curl "https://queue.modelrunner.run/depth-anything/v2/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MRUN_API_KEY"
curl "https://queue.modelrunner.run/depth-anything/v2/requests/$REQUEST_ID" \
  -H "Authorization: Key $MRUN_API_KEY"

JavaScript

import { modelrunner } from "@modelrunner/client";

const result = await modelrunner.subscribe("depth-anything/v2", {
  input: {
    "image_url": "https://media.modelrunner.ai/x8hj4rin7S47k8s4XhswB.png"
  },
});
console.log(result);

Python

import os
import requests

headers = {"Authorization": f"Key {os.environ['MRUN_API_KEY']}"}

submitted = requests.post(
    "https://queue.modelrunner.run/depth-anything/v2",
    headers=headers,
    json={
      "image_url": "https://media.modelrunner.ai/x8hj4rin7S47k8s4XhswB.png"
    },
).json()

# Poll submitted["status_url"] until "COMPLETED", then:
result = requests.get(submitted["response_url"], headers=headers).json()

Input parameters

Input parameters of Depth Anything V2
NameTypeRequiredDescription
image_urlstring (uri)yesURL of the image to generate a depth map from.

Machine-readable: OpenAPI schema · llms.txt

Use Depth Anything V2 from Claude & Cursor (MCP)

Point Claude Code, Claude Desktop, Cursor, or any MCP client at the ModelRunner MCP server and Depth Anything V2 becomes a tool your assistant can call directly — it authorizes via OAuth (no API key in config) and runs this model with the run_model tool using the endpoint depth-anything/v2.

MCP client config (Claude Desktop, Cursor)

{
  "mcpServers": {
    "modelrunner": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.modelrunner.run/mcp"]
    }
  }
}

Claude Code

claude mcp add --transport http modelrunner https://mcp.modelrunner.run/mcp

Then ask your assistant, for example: “Run depth-anything/v2 on ModelRunner to generate image”. MCP setup guide.

Model Detayları

Model Detayları

Depth Anything V2, tek görüntüden derinlik tahmini yapar: bir fotoğraf verirsiniz, o da daha parlak piksellerin daha yakını, daha koyu piksellerin daha uzağı gösterdiği gri tonlamalı bir derinlik haritası döndürür. Prompt, kamera verisi ya da elle ince ayar gerekmez — içeri tek bir görsel URL’si girer, dışarı aynı boyutlarda tek bir derinlik haritası görsel URL’si çıkar. Tek görüntüden derinlik tahmini için geliştirilen Depth Anything V2 temel modeli (NeurIPS 2024) üzerine kuruludur; iç mekân sahnelerinde, dış mekân manzaralarında, portrelerde ve sentetik render’larda temiz ve sağlam derinlik üretir — derinlik koşullu görsel üretiminde ilk akla gelen preprocessor olmasının nedeni de budur.\n\n## En uygun olduğu işler\n- ControlNet / derinlik koşullu diffusion pipeline’larını yönlendirecek bir derinlik haritası kontrol görseli üretmek\n- Derinlik sensörü olmadan sıradan bir fotoğraftan piksel başına göreli derinlik tahmin etmek\n- 2.5D paralaks, yeniden aydınlatma, sis ve kompozit için derinlik pass’ları hazırlamak\n- 3D rekonstrüksiyon ya da sahne anlama için referans fotoğrafları derinlik haritalarına dönüştürerek ön işlemden geçirmek\n- Tek tip bir görünüm için bir grup durağan görselde tutarlı derinlik koşullandırması üretmek\n\n## Şu durumlarda başka bir model seçin\n- Derinlik yerine kenar/çizgi koşullandırması istiyorsanız — bir Canny ya da line-art preprocessor’ı kullanın\n- Fotoğrafın derinliğini tahmin etmek yerine fotoğrafın kendisini üretmek ya da düzenlemek istiyorsanız — bir text-to-image ya da görsel düzenleme modeli kullanın\n- Çıktı olarak 2D bir derinlik görseli yerine dokulu bir 3D mesh gerekiyorsa — bir image-to-3D modeli kullanın\n- Gerçek dünya birimlerinde gerçek metrik derinlik gerekiyorsa — bu model kalibre edilmiş mesafeleri değil, göreli derinliği tahmin eder\n\n## İpuçları\n- Elinizdeki en yüksek çözünürlüklü kaynağı verin; derinlik haritası girdinin boyutlarında döner, yani ne kadar detay verirseniz o kadar detay alırsınız.\n- Ön plan/arka plan ayrımı net olan fotoğraflar, sonraki koşullandırma adımları için en kullanışlı haritaları verir.\n- Çıktı, doğrudan bir depth ControlNet’e kontrol görseli olarak verebileceğiniz standart bir gri tonlamalı görseldir.\n\n## Sınırlamalar\n- Metrik değil, göreli derinlik tahmin eder — değerler görseller arasında değil, yalnızca tek bir görselin içinde karşılaştırılabilir.\n- İnce yapılar, yansıtıcı ve saydam yüzeyler ve aşırı yakın çekimler belirsiz sonuç verebilir.\n\nModelRunner JavaScript client ile çalıştırmak için:\n```js\nimport { modelrunner } from \"@modelrunner/client\";\n\nconst result = await modelrunner.subscribe(\"depth-anything/v2\", {\n input: {\n image_url: \"https://media.modelrunner.ai/example-scene.png\",\n },\n});\n```